Reddit Place Script 2022

About

This is a script to draw an image onto r/place (https://www.reddit.com/r/place/).

Features

Support for multiple accounts
Determines the cooldown time remaining for each account
Detects existing matching pixels on the r/place map and skips them
Automatically converts colors to the r/place color palette
Easy(ish) to read output with colors

Requirements

How to Get App Client ID and App Secret Key

You need to generate an app client id and app secret key for each account in order to use this script. Or, just create one, and add each username as a developer in the developer app settings. You will need to duplicate the client ID and secret in .env, though.

Steps:

Visit https://www.reddit.com/prefs/apps
Click "create (another) app" button at very bottom
Select the "script" option and fill in the fields with anything

Python Package Requirements

Install requirements from 'requirements.txt' file.

Windows

pip install -r requirements.txt

Other OS

pip3 install -r requirements.txt

Get Started

Move the file 'config_example.json' to config.json

Edit the values to replace with actual credentials and values

{
    // [x,y] where you want the top left pixel of the local image to be drawn on canvas
    "image_start_coords": [741, 610],
    // delay between starting threads (can be 0)
    "thread_delay": 2,
    // array of accounts to use
    "workers": {
        // username of account 1
        "worker1username": {
            // password of account 1
            "password": "password",
            // appid and secret (see How To Get App Client ID And App Secret Key)
            "client_id": "clientid",
            "client_secret": "clientsecret",
            // which pixel of the image to draw first
            "start_coords": [0, 0]
        },
        // username of account 2
        "worker1username": {
            // password of account 2
            "password": "password",
            // appid and secret (see How To Get App Client ID And App Secret Key)
            "client_id": "clientid",
            "client_secret": "clientsecret",
            // which pixel of the image to draw first
            "start_coords": [0, 0]
        }
        // etc... add as many accounts as you want (but reddit may detect you the more you add)
    }
}

Notes

Change image.jpg/png to specify what image to draw. One pixel is drawn every 5 minutes. PNG takes priority over JPG.

Run the Script

python3 main.py

Multiple Workers

Just create multiple child arrays to "workers" in the .json

{
  "image_start_coords": [741, 610],
  "thread_delay": 2,

  "workers": {
    "worker1username": {
      "password": "password",
      "client_id": "clientid",
      "client_secret": "clientsecret",
      "start_coords": [0, 0]
    },
    "worker2username": {
      "password": "password",
      "client_id": "clientid",
      "client_secret": "clientsecret",
      "start_coords": [0, 50]
    }
  }
}

In this case, the first worker will start drawing from (0, 0) and the second worker will start drawing from (0, 50) from the input image.jpg file.

This is useful if you want different threads drawing different parts of the image with different accounts.

Other Settings

{
    "thread_delay": 2,
}

thread_delay Adds a delay between starting a new thread. Can be used to avoid ratelimiting
Transparency can be achieved by using the RGB value (69, 42, 0) in any part of your image
If you'd like, you can enable Verbose Mode by adding --verbose to "python main.py". This will output a lot more information, and not neccessarily in the right order, but it is useful for development and debugging.

Developing

The nox CI job will run flake8 and black on the code. You can also do this locally by pip installing nox on your system and running nox in the repository directory.

c-herz/reddit-place-script-2022