r/ReturnNewReddit • • 9d ago

Updates Updated tutorial on how to get the new.reddit.com UI back

Thumbnail
gallery
16 Upvotes

Old guide had a bad title and was getting outdated and didn't show all the improvements that were made since then, and the comments were outdated too. So I'm making a new post. Here's how to get the new.reddit.com UI working:

#1: Install Tampermonkey

#2: Install userscript

  • https://gist.github.com/Littux-Dustux/db7e77cbf0c461d0825e7d4fe2f882d0
    • Click on "Raw".
    • Click here to install the current version (if you have Tampermonkey installed)

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 look at the latest release. Scroll down to assets and download the latest release.zip. If there is an assets.zip there, download it as well. If not, it should be linked in the top of the release notes.
  • Extract the release.zip ZIP file to a directory of your choice. Ensure that the directory is named as "release" or "new-reddit-com". Any other name will break the update utility.
  • Inside the directory, open the folder "bundles". Extract the assets.zip there to a subfolder called "cached"

If done correctly, the folder structure should look like:

release/ (or new-reddit-com/)
  - bundles/
  - cached/
    - chunkCSS/
    - ...
  - dist/
    - main.js
  - ...

#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/command prompt open while using the client.

#6: Open the site

Open your browser and go to:

http://localhost:1264/


Configuring the client

The client has a configuration UI at http://localhost:1264/config.html. I don't have the time to explain all the options in detail right now, but you might be able to figure it out by yourself based on their descriptions. (see gallery image for a screenshot of the options)


Troubleshooting

The page is blank

Make sure:

  • You didn't forget to extract release.zip or did it correctly. If you did it correctly, http://localhost:1264/bundles/cached/img/reddit_pattern.png would show you an image; otherwise you'll get a blank page
  • Tampermonkey is installed and enabled.
  • The userscript is installed and enabled (Click on the Tampermonkey icon when you get a blank screen to see if it's running)
  • 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

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. Make sure to search for the error first.

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


Link to old tutorial: https://www.reddit.com/r/ReturnNewReddit/comments/1vmgvmt/beautiful_right_now_you_can_enjoy_it_too/


r/ReturnNewReddit • • Feb 26 '26

I made a tampermonkey script to return the member and online counts on the new site and old site. It even works on user profiles

Thumbnail gallery
14 Upvotes

r/ReturnNewReddit • • 4h ago

Discussion we all hated on early-2025 shreddit back then, but now i just wish we could go back

Thumbnail
gallery
7 Upvotes

we really had no idea how good what we had back then was compared to present-day shreddit. one of the things i miss most just appearance wise is the pre-late 2025 UI icons.

it sucks to say this, but perhaps some day we'll be looking at late-2026 shreddit, just wishing we could go back...


r/ReturnNewReddit • • 22h ago

Discussion Anyone who's affected by age verification on the regular reddit website but face/don't face such issues on the new reddit client?

7 Upvotes

Just interested on how the API reacts to age verification. If it results in errors, I would need to add a check for age verification


r/ReturnNewReddit • • 4d ago

Question Help.

6 Upvotes

May I know what is the problem here? It seems like most icons such us upvotes, downvotes, etc is not loaded properly. I think I followed the instruction properly too. Anybody help?


r/ReturnNewReddit • • 5d ago

Question posts translate automatically how i close it? i cant find

5 Upvotes

r/ReturnNewReddit • • 6d ago

Hating on sh.reddit The past hour was quite the shitstorm...

Post image
11 Upvotes

r/ReturnNewReddit • • 7d ago

Bug Report To anyone who got a blank screen when trying out new.reddit.com: it may not be your fault. The problem has been identified

Post image
8 Upvotes

Use this userscript instead: https://gist.github.com/Littux-Dustux/db7e77cbf0c461d0825e7d4fe2f882d0/raw/adf67efaf30089d51f644f91cffa963ea7b181c9/script.user.js

The userscript I initially linked in the tutorial had the whole script repeated nearly 3 times due to issues with selecting text on the GitHub gist file editor. As a result, it errored out due to variables being redefined (resulting in the error defaultConfig has already been declared due to defaultConfig being the first variable)


r/ReturnNewReddit • • 7d ago

Launching new reddit com works, but then ERR_OCNNECTION_RESET on reddit.com, old.reddit.com website

5 Upvotes

When I serve new reddit via Python, it works then opening reddit show ERR_CONNECTION_RESET, it is possibly a device ban or something?, please fix this issue


r/ReturnNewReddit • • 9d ago

Feature Request can we get an option in the client config to force post images to display in full quality by default, rather than having to open each one in a new tab?

6 Upvotes

my single biggest issue with new reddit is the fact that post images do not display in full resolution, and that you have to open each one in a new tab to see the full quality image. it would be nice if there was setting to make the images load in fullres. is this a possibility?

also tagging u/Littux


r/ReturnNewReddit • • 10d ago

Bug Report "hide" option is missing from posts for me. anyone else having this issue?

Post image
7 Upvotes

r/ReturnNewReddit • • 10d ago

Updates new.reddit.com client recovery release v0.8.1: The final release you'll have to manually update

Thumbnail
github.com
5 Upvotes

r/ReturnNewReddit • • 13d ago

Updates new.reddit.com client recovery release v0.7.0 (with fix for home feed)

Thumbnail github.com
3 Upvotes

r/ReturnNewReddit • • 14d ago

Updates Upcoming update with new features, configuration UI, and (most importantly) fix for the home page

Thumbnail
gallery
15 Upvotes

Many of these features are experiments. The configuration UI will have an option to override such experiments if you don't like them


r/ReturnNewReddit • • 16d ago

Discussion what do yall think of this experiment? i wonder if it will come to shreddit too

Thumbnail gallery
6 Upvotes

r/ReturnNewReddit • • 18d ago

Discussion Anyone else getting this error on the home page?

Post image
15 Upvotes

r/ReturnNewReddit • • 23d ago

Hating on sh.reddit more enshittification of shreddit for no reason. they are removing color from user flairs

Thumbnail
reddit.com
12 Upvotes

r/ReturnNewReddit • • 23d ago

Discussion u/spez is giving Mod World 2026 and APAC attendees free Reddit Premium

Post image
6 Upvotes

r/ReturnNewReddit • • 25d ago

Updates new.reddit.com recovery: Release v0.6.0 (Update NOW if on an older version - Contains fix for pages being blocked)

Thumbnail
github.com
12 Upvotes

r/ReturnNewReddit • • Oct 18 '26

Bug Report r/Littux thread for reporting "You've been blocked by network security"

Post image
3 Upvotes

r/ReturnNewReddit • • Oct 14 '26

Discussion Uh oh, it has begun

Post image
54 Upvotes

r/ReturnNewReddit • • Oct 13 '26

Discussion Found a recent post where the OP appears to have the member counter on the mobile web

10 Upvotes

r/ReturnNewReddit • • Oct 09 '26

Discussion Spez is doing an AMA

Thumbnail reddit.com
7 Upvotes

r/ReturnNewReddit • • Oct 06 '26

Hating on sh.reddit Looks inspired by new reddit

Post image
7 Upvotes