{"id":31600235,"url":"https://github.com/wewebunnyx/le-termuddit","last_synced_at":"2026-04-11T17:43:53.093Z","repository":{"id":293514922,"uuid":"973089957","full_name":"WeWeBunnyX/Le-Termuddit","owner":"WeWeBunnyX","description":"A Reddit CLI Feeder / Terminal Browser Client ","archived":false,"fork":false,"pushed_at":"2025-09-19T18:30:17.000Z","size":775,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-19T20:58:56.268Z","etag":null,"topics":["api","bash","chafa","cli","curl","gnu-linux","jq","linux","oauth2","operating-systems","reddit","terminal"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WeWeBunnyX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-26T08:29:05.000Z","updated_at":"2025-09-19T18:30:21.000Z","dependencies_parsed_at":"2025-05-15T18:44:12.129Z","dependency_job_id":"0a53bf55-4245-46ca-ac1f-ddb7ee6d9fc2","html_url":"https://github.com/WeWeBunnyX/Le-Termuddit","commit_stats":null,"previous_names":["wewebunnyx/le-termuddit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WeWeBunnyX/Le-Termuddit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeWeBunnyX%2FLe-Termuddit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeWeBunnyX%2FLe-Termuddit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeWeBunnyX%2FLe-Termuddit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeWeBunnyX%2FLe-Termuddit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WeWeBunnyX","download_url":"https://codeload.github.com/WeWeBunnyX/Le-Termuddit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeWeBunnyX%2FLe-Termuddit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278572005,"owners_count":26008686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["api","bash","chafa","cli","curl","gnu-linux","jq","linux","oauth2","operating-systems","reddit","terminal"],"created_at":"2025-10-06T06:54:05.147Z","updated_at":"2025-10-06T06:54:07.689Z","avatar_url":"https://github.com/WeWeBunnyX.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Termuddit Logo](logo.png)\n\n# Termuddit - Reddit CLI Client\n\nA command-line interface Reddit client written in Bash that lets you browse Reddit from your terminal with a clean, colorful interface.\n\n![Termuddit Screenshot](demonstration/screenshot.png)\n![Termuddit Screenshot](demonstration/demo4.png)\n![Termuddit Screenshot](demonstration/demo2.png)\n![Termuddit Screenshot](demonstration/demo5.png)\n\n## Features\n\n- 🎨 Colorful and clean terminal interface\n- 👀 Browse subreddits and view posts\n- 🖼️ View images as ASCII art in terminal\n- 💬 View nested comments with proper threading\n- 🔄 Refresh posts and comments\n- 🎯 Load more comments on demand\n- 🔒 Secure credential management\n- 🚀 Fast and lightweight\n\n## Prerequisites\n\n- Bash 4.0+\n- `curl`\n- `jq` (JSON processor)\n- `figlet` (for splash screen)\n- `chafa` (for ASCII art images)\n- Reddit API credentials\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/WeWeBunnyX/Le-Termuddit.git\ncd Le-Termuddit\n```\n\n2. Make scripts executable:\n```bash\nchmod +x *.sh\n```\n\n3. Install dependencies:\n\n### Ubuntu/Debian\n```bash\nsudo apt install jq curl figlet chafa\n```\n\n### Fedora/RHEL\n```bash\nsudo dnf install jq curl figlet chafa\n```\n\n### Arch Linux\n```bash\nsudo pacman -S jq curl figlet chafa\n```\n\n### macOS (using Homebrew)\n```bash\nbrew install jq curl figlet chafa\n```\n\n### Using Package Manager Alternatives\n| Distribution | Package Manager | Command |\n|-------------|----------------|---------|\n| OpenSUSE    | zypper         | `sudo zypper install jq curl figlet chafa` |\n| Alpine      | apk            | `sudo apk add jq curl figlet chafa` |\n| Gentoo      | emerge         | `sudo emerge jq curl figlet chafa` |\n| Void Linux  | xbps           | `sudo xbps-install -S jq curl figlet chafa` |\n\n## Setup\n\n1. Create a Reddit App:\n   - Go to [https://www.reddit.com/prefs/apps](https://www.reddit.com/prefs/apps)\n     \n   - Click \"Create App\" or \"Create Another App\"\n   - ![Termuddit Screenshot](https://i.ibb.co/Kx1Ys3YJ/Screenshot-From-2025-09-21-11-44-08.png)\n     \n   - Fill in the required information and click 'create app' (name and description field can be anything you like, select script as the type and redirect uri as shown below)\n     ![Termuddit Screenshot](https://i.ibb.co/0jWM59jg/Screenshot-From-2025-09-21-12-20-45.png)\n\n   - Note your Client ID and Client Secret\n     ![Termuddit Screenshot](https://i.ibb.co/tPwTSKCq/Screenshot-From-2025-09-21-12-21-35.png)\n\n\n2. Run Termuddit:\n```bash\n./termuddit.sh\n```\n\n3. Enter your Reddit API credentials when prompted\n   ![Termuddit Screenshot](https://i.ibb.co/B5m9ry8L/Screenshot-From-2025-09-21-14-18-42.png)\n\n\n## Usage\n\n**1**. Start the application:\n```bash\n./termuddit.sh --noimg\n```\n\nOr just use ```./termuddit.sh``` to render images along with the post (without --noimg flag). The images are converted to ASCII art and may not be in full quality/resolution due to terminal limitations\n\n**2**. Enter a subreddit name when prompted (e.g., \"linux\", \"programming\")\n\n**3**. Choose number of posts to fetch\n\n### Navigation\n\n- Enter post number to view its comments\n- `r` - Refresh posts\n- `q` - Return to main menu\n\n### Comment View\n\n- `m` - Load more comments\n- `r` - Refresh current comments\n- `q` - Return to posts view\n\n### Image Display (use ```-noimg``` flag to disable)\n\nImages in posts are automatically converted to ASCII art using `chafa`. The quality depends on:\n- Terminal color support (256 colors recommended)\n- Terminal font (Unicode support required)\n- Terminal window size\n\n## Project Structure\n\n```\ntermuddit/\n├── termuddit.sh      # Main script\n├── authenticate.sh    # Reddit API authentication\n├── get_posts.sh      # Post fetching and display\n├── get_comments.sh   # Comment fetching and display\n└── splash.sh         # Splash screen\n```\n\n## Security\n\n- Credentials are stored locally in `credentials.txt`\n- Access token is stored in `access_token.txt`\n- Both files are git-ignored\n\n## Contributing\n\nContributions are welcome, you may open a pull request or submit an issue.\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments/References\n\n- [Reddit API Documentation](https://www.reddit.com/dev/api/)\n- [Reddit OAuth2 Guide](https://github.com/reddit-archive/reddit/wiki/OAuth2)\n- [JQ Manual](https://stedolan.github.io/jq/manual/)\n- [Bash Documentation](https://www.gnu.org/software/bash/manual/)\n- [Chafa Documentation](https://hpjansson.org/chafa/)\n- [Figlet Documentation](http://www.figlet.org/)\n\n## Author\n\n- WeWeBunnyX ([@WeWeBunnyX](https://reddit.com/u/WeWeBunnyX))\n\n## Support\n\nIf you found this project helpful, please give it a ⭐️!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwewebunnyx%2Fle-termuddit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwewebunnyx%2Fle-termuddit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwewebunnyx%2Fle-termuddit/lists"}