Skip to content

A web client for Everything with authenticated logins and a variety of browsing options

License

Notifications You must be signed in to change notification settings

everything-gripe/troddit-for-everything

 
 

Repository files navigation

Troddit for Everything

A front end web client for Everything

Live at client.everything.gripe

Screenshots

Flexible column viewing.

Shown browsing a multi-reddit. Subreddits pane and options menu open. columns_options

Classic rows view

classicrows_light

with inline media expansion and custom reddit video player

lightmode_row_open

Open posts with comments to the side and use arrows for navigation

post_open

Search for groups, users, and posts.

Shown in single column mode with wide UI disabled. Sort options menu is open. search_narrow

Fully responsive, downloadable as PWA

responsive_troddit

Features

  • Secure logins with Reddit to enable voting, commenting, managing your subreddits and multireddits (aka feeds), and access to your personal front page.
  • 'Offline mode' to follow subreddits and manage multis locally without login. Autogenerates a personal front page.
    • Visit your subreddits multi and copy the multireddit link. Replace 'reddit' with 'troddit' in the URL and then use the 'Join All' option to quickly follow all subs locally.
  • Search Reddit for posts or subreddits quickly with auto-complete.
  • Filter posts by type (Images, Video/GIFs, Links, Self)
  • View posts in single column, custom multi-column with a grid-masonry layout, or a simple row mode. All with infinite-scrolling.
  • Choose your card style: Original for full post text in card, Compact to exclude post text, or Media to hide all text and card padding.
  • Gallery view: Click on a post and navigate through the feed with on screen buttons or your arrow keys. Shows the post content as well as its comments from Reddit. Smart portrait mode to automatically arrange vertical photos and videos side by side with comments.
  • Hover mouse over Reddit videos to play. Enable to Autoplay option to play videos automatically when entering the viewport. Enable the Audio option to play sound on hover as well.
  • Responsive desktop and mobile layouts.
  • PWA to download to your computer or phone.
  • Docker support

Developing

Clone the repo and install all packages with npm or yarn. Then to run development server:

npm run dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

To contribute create a branch and submit a PR!

Environment Variables

To use login functionality the following environment variables need to be defined in a .env.local file placed in the root directory:

CLIENT_ID=<ID of your Everything app>
CLIENT_SECRET=<Secret from your Everything app>
EVERYTHING_REDIRECT=http://localhost:3000/api/auth/callback/everything
NEXTAUTH_SECRET=<See https://next-auth.js.org/configuration/options#secret>
NEXTAUTH_URL=http://localhost:3000

Docker

To Deploy the Docker Image

docker pull everything-gripe/troddit
docker run -d --name troddit -p 3000:3000 everything-gripe/troddit

Alternatively for arm64:

docker pull everything-gripe/troddit:arm64

To Build the Image Yourself

By default, the Docker will expose port 3000, so change this within the Dockerfile if necessary. When ready, simply use the Dockerfile to build the image.

git clone https://github.com/everything-gripe/troddit-for-everything
cd troddit
docker build . -t troddit

This will create the troddit image and pull in the necessary dependencies. To run:

docker run -p 3000:3000 troddit

Support

If you like the project feel free to share and leave a star. If you're feeling generous you can support me on Ko-fi.

ko-fi

About

A web client for Everything with authenticated logins and a variety of browsing options

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.0%
  • JavaScript 1.1%
  • Other 0.9%