{"id":37184544,"url":"https://github.com/tonymajestro/reddit-tui","last_synced_at":"2026-01-14T21:19:46.780Z","repository":{"id":271937513,"uuid":"912509222","full_name":"tonymajestro/reddit-tui","owner":"tonymajestro","description":"Terminal UI for reddit","archived":false,"fork":false,"pushed_at":"2025-05-22T01:07:36.000Z","size":33676,"stargazers_count":125,"open_issues_count":8,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-22T02:22:30.346Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tonymajestro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-05T19:10:22.000Z","updated_at":"2025-05-22T01:07:40.000Z","dependencies_parsed_at":"2025-01-10T21:45:47.676Z","dependency_job_id":"79a144af-0b0e-4119-b620-8a016d44e7a8","html_url":"https://github.com/tonymajestro/reddit-tui","commit_stats":null,"previous_names":["tonymajestro/reddit-tui"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/tonymajestro/reddit-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonymajestro%2Freddit-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonymajestro%2Freddit-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonymajestro%2Freddit-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonymajestro%2Freddit-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tonymajestro","download_url":"https://codeload.github.com/tonymajestro/reddit-tui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonymajestro%2Freddit-tui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28434773,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-14T21:19:46.069Z","updated_at":"2026-01-14T21:19:46.764Z","avatar_url":"https://github.com/tonymajestro.png","language":"Go","funding_links":[],"categories":["\u003ca name=\"online\"\u003e\u003c/a\u003eOnline search and resources"],"sub_categories":[],"readme":"# Reddittui\nA lightweight terminal application for browsing Reddit from your command line. Powered by [bubbletea](https://github.com/charmbracelet/bubbletea)\n\n## Features\n- **Subreddit Browsing:** Navigate through your favorite subreddits.\n- **Post Viewing:** Read text posts and comments.\n- **Keyboard Navigation:** Scroll and select posts using vim/standard keyboard shortcuts.\n- **Configurable**: Customize caching behavior and define subreddit filters using a configuration file\n\n## Demo\nhttps://github.com/user-attachments/assets/40d61ef3-3a95-4a26-8c49-bec616f6ae1c\n\n## Installation\n\n### Git\n#### Prerequisites\n- **Git**\n- **Go:** Version 1.16 or newer\n- **Terminal:** A Unix-like terminal (Linux, macOS, or similar).\n- **POSIX Utilities:** The `install` command is used for installation, which is available on both Linux and macOS.\n\nClone the repository and run the install script: \n\n```bash\ngit clone https://github.com/tonymajestro/reddit-tui.git reddittui\ncd reddittui\n./install.sh\n```\n\nTo remove reddittui run the uninstall script:\n\n```bash\n./uninstall.sh\n```\n\n### Arch\nArch users can install reddittui from the AUR using yay or other AUR helpers.\n\n[Pre-compiled](https://aur.archlinux.org/packages/reddit-tui-bin) and [source packages](https://aur.archlinux.org/packages/reddit-tui) are available.\n\n```bash\nyay -S reddit-tui-bin\n```\n\n```bash\nyay -S reddit-tui\n```\n\n### Nix\nNix users can try it in a shell or add it to their system config like this.\n```bash\nnix-shell -p reddit-tui\n```\n```nix\n  environment.systemPackages = [\n      pkgs.reddit-tui\n    ];\n```\n\n## Usage\nRun the installed binary from your preferred terminal:\n\n```bash\n# Open reddittui, navigating to the home page\nreddittui\n\n# Open reddittui, navigating to a specific subreddit\nreddittui --subreddit dogs\n\n# Open reddittui, navigating to a specific post by its ID\nreddittui --post 1iyuce4\n```\n\n## Keybindings\n- Navigation\n  - **h, j, k, l:** Vim movement\n  - **left, right, up, down:** Normal movement\n  - **g**: Go to top of page\n  - **G**: Go to bottom of page\n  - **s**: Switch subreddits\n- Posts page\n  - **L**: Load more posts\n- Comments page\n  - **o**: Open post link in browser\n  - **c**: Collapse comments\n- Misc\n  - **H:** Go to home page\n  - **backspace**: Go back\n  - **q, esc**: Exit reddittui\n\n## Configuration files\nAfter running the reddittui binary, the following files will be initialized:\n- Configuration file:\n  - `~/.config/reddittui/reddittui.toml`\n- Log file:\n  - `~/.local/state/reddittui.log`\n- Cache\n  - `~/.cache/reddittui/`\n\nSample configuration:\n```toml\n# Core configuration\n[core]\nbypassCache = false\nlogLevel = \"Warn\"\n\n# Filter out posts containing keywords or belonging to certain subreddits\n[filter]\nsubreddits = [\"news\", \"politics\"]\nkeywords = [\"pizza\", \"pineapple\"]\n\n# Configure client timeout and cache TTL. By default, subreddit posts and comments are cached for 1 hour.\n[client]\ntimeoutSeconds = 10\ncacheTtlSeconds = 3600\n\n# Configure which reddit server to use. Default is old.reddit.com but redlib servers are also supported\n[server]\ndomain = \"old.reddit.com\"\ntype = \"old\"\n```\n\n## Redlib\nFor enhanced privacy, private [Redlib backends](https://github.com/redlib-org/redlib) are supported. A list of Redlib servers can be found [here](https://github.com/redlib-org/redlib-instances/blob/main/instances.json). Use the following configuration to use a Redlib server instead of old.reddit.com:\n\n```toml\n[server]\ndomain = \"safereddit.com\"\ntype = \"redlib\"\n```\n\n## Acknowledgments\nReddittui is based on the [bubbletea](https://github.com/charmbracelet/bubbletea) framework. It also takes inspiration from [circumflex](https://github.com/bensadeh/circumflex), a hackernews terminal browser.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftonymajestro%2Freddit-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftonymajestro%2Freddit-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftonymajestro%2Freddit-tui/lists"}