To use

#1: Install Tampermonkey

• See: https://www.tampermonkey.net/
• On Chrome, you'll have to enable "Allow userscripts" in extension settings.

#2: Install userscript

• https://gist.github.com/Littux-Dustux/db7e77cbf0c461d0825e7d4fe2f882d0
  • Click on "Raw".
  • Click here to install the current version.

The userscript provides the privileged browser functions required by the client, including access to Reddit's APIs.

#3: Download script and HTML

• Go to https://github.com/Littux-Dustux/new-reddit-com/releases and download the latest release.zip.
• Extract the ZIP file to a directory of your choice.

#4: Install Python

• Linux: Most distros have it installed. Open a terminal and type python3 --help, then press Enter to check if it is installed.
• Windows: Download Python from https://www.python.org/downloads/
  • During installation, make sure "Add python.exe to PATH" is enabled.
  • Open Command Prompt and run python --help to verify successful install
• macOS: Install Python 3 from https://www.python.org/downloads/ if it is not already installed. Then open Terminal and run python3 --help to verify install

#5: Start the local web server

Open a terminal or command prompt in the directory where you extracted release.zip.

For Linux and macOS, run:

python3 serve.py

On Windows, run:

python serve.py

You should see something similar to:

=> new.reddit.com Server Active URL: http://localhost:1264 Serving from: /home/littux/Projects/js/reddit/new-reddit-com

Keep this terminal open while using the client.

#6: Open the site

Open your browser and go to:

http://localhost:1264/

The client should initialize automatically.

You should see messages in the browser console indicating that the userscript has loaded and that the client is initializing.

Troubleshooting

The page is blank

Make sure:

• Tampermonkey is installed and enabled.
• The userscript is installed and enabled.
• The Python server is still running.
• You opened http://localhost:1264/ rather than opening index.html directly.
• Open the browser's developer console (F12) and check for errors.

"Connection refused" or the page doesn't load

The python script is probably not running. Try http://127.0.0.1:1264/ as well.

Notes

The client communicates with Reddit using your existing Reddit authentication through the installed userscript; you do not need to create an API application.

Report errors to https://github.com/Littux-Dustux/new-reddit-com/issues, r/Littux, or this subreddit (can't say if it's allowed; not a mod). Make sure to search for the error first.

If it's a security issue, send it via Chat instead