{"id":15136471,"url":"https://github.com/nssharmaofficial/reddit-hole","last_synced_at":"2025-10-23T11:31:34.508Z","repository":{"id":250776113,"uuid":"828257035","full_name":"nssharmaofficial/reddit-hole","owner":"nssharmaofficial","description":"Automated reddit scraper and video creator","archived":false,"fork":false,"pushed_at":"2024-09-24T10:12:31.000Z","size":393,"stargazers_count":12,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-30T18:06:03.100Z","etag":null,"topics":["amazon-polly","amazon-polly-api","automation","aws","captioning","openai","openai-whisper","reddit","reddit-bot","reddit-crawler","reddit-scraper","tts","whisper"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/channel/UCLbMgN2yQUciVHRnfb2cydA","language":"Python","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/nssharmaofficial.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}},"created_at":"2024-07-13T15:28:47.000Z","updated_at":"2024-11-17T18:30:33.000Z","dependencies_parsed_at":"2024-07-30T03:04:19.624Z","dependency_job_id":"e4e49e87-fd79-4708-8af7-fbc1f4b5aa5d","html_url":"https://github.com/nssharmaofficial/reddit-hole","commit_stats":null,"previous_names":["nssharmaofficial/reddit-hole"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nssharmaofficial%2Freddit-hole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nssharmaofficial%2Freddit-hole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nssharmaofficial%2Freddit-hole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nssharmaofficial%2Freddit-hole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nssharmaofficial","download_url":"https://codeload.github.com/nssharmaofficial/reddit-hole/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237821555,"owners_count":19371784,"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","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":["amazon-polly","amazon-polly-api","automation","aws","captioning","openai","openai-whisper","reddit","reddit-bot","reddit-crawler","reddit-scraper","tts","whisper"],"created_at":"2024-09-26T06:22:01.673Z","updated_at":"2025-10-23T11:31:29.108Z","avatar_url":"https://github.com/nssharmaofficial.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# reddit-hole 🐰\n\n\u003cimg src=\"docs/reddit-banner.png\" alt=\"reddit-create-app\" width=\"400\"/\u003e\n\n**Let me ask you:**\n\n- 🙋 Would you like to start uploading the trendy Reddit videos on some platform too? \n- 😨 Are you overwhelmed by the existing solution of [RedditVideoMakerBot](https://github.com/elebumm/RedditVideoMakerBot) as it lacks readability and it is hard to modify it on your own?\n- 😴 Are you tired of debugging all the issues of the simpler version of it [YoutubeAutomation-Reddit](https://github.com/aahashemi/YouTubeAutomation-Reddit/tree/main)?\n\n**If you replied ⭐ *yes* ⭐ to any of the question above, this is the right place for you! Why this project stands out?**\n\n- 😏 option to choose from creating long \"storymode\" videos with captions or shorts with the comments' screenshots\n- 📒 proper code documentation and readability\n- ✅ keeping it simple but configurable (easy to contribute!)\n\n## Examples 🎥\n\n👉 [long \"storymode\" video](https://www.youtube.com/watch?v=5CCY67G0FBg\u0026t=24s)\n\n👉 [shorts](https://www.youtube.com/shorts/bmCKxse31s8)\n\n## File structure\n\n```plaintext\nreddit-hole/\n├── assets/\n│   ├── background/\n│   ├── fonts/\n│   ├── temp/\n│   ├── config.toml\n│   ├── cookie-dark-mode.json\n│   ├── cookie-light-mode.json\n│   ├── database.json\n│   └── my_title_template.png\n├── docs/\n├── env/\n├── results/\n│   ├── long/\n│   ├── short/\n├── utils/\n│   ├── captions.py\n│   ├── helpers.py\n│   ├── reddit.py\n│   ├── tts.py\n│   └── videomaker.py\n├── .env\n├── .gitignore\n├── LICENSE\n├── main.py\n├── README.md\n└── requirements.txt\n```\n\n## Installation 👨‍💻\n\n1. Clone this repository\n1. Create virtual environment and install all dependencies\n\n   ```bash\n   python -m venv env\n   source env/bin/activate\n   pip install -r requirements.txt\n   python -m playwright install and python -m playwright install-deps\n   ```\n1. Create `.env` file to store environment variables\n1. Setup [AWS (Free Tier)](https://aws.amazon.com/)\n   - Sing in to the console\n   - Create **access key** and save it along with the **secret access key**\n   - Save it in the `.env` file\n\n      ```.env\n      # .env\n      AWS_ACCESS_KEY_ID=\n      AWS_SECRET_ACCESS_KEY=\n      AWS_REGION_NAME=\n      ```\n\n1. Go to [Reddit App Preferences](https://www.reddit.com/prefs/apps) and click on create another app at the bottom.\n   - Fill out the required details, make sure to select **script** and click on create app.\n\n     \u003cimg src=\"docs/reddit1.png\" alt=\"reddit-create-app\" width=\"600\"/\u003e\n\n   - Make a note of the **personal use script** and  **secret token** and update the the following credentials in the `config.toml` file. \n\n     \u003cimg src=\"docs/reddit2.png\" alt=\"reddit-save-tokens\" width=\"600\"/\u003e\n\n   - Save it in the `.env` file along with your credentials:\n\n      ```.env\n      # .env\n      REDDIT_CLIENT_ID=\n      REDDIT_CLIENT_SECRET=\n      REDDIT_USERNAME=\n      REDDIT_PASSKEY=\n      ```\n1. Download any YouTube video as a background\n   - Here are a few options:\n      - [Minecraft (1:20 h)](https://youtu.be/n_Dv4JMiwK8) \n      - [GTA (1:00 h)](https://youtu.be/qdvjZ1bUw68) \n      - [Subway Surfer (1:05 h)](https://youtu.be/ChBg4aowzX8)\n   - Save the path in the `.env` file:\n\n      ```.env\n      # .env\n      BACKGROUND=\"/reddit-hole/assets/background/minecraft.mp4\"\n      ```\n\n1. Setup configuration in [config](/assets/config.toml):\n\n   ```.toml\n   [Reddit]\n   subreddit='AskReddit'\n\n   [settings]\n   storymode=false\n   opacity = 0.75\n   resolution_w = 1920\n   resolution_h = 1080\n   pause=0.6\n   multiple_voices=false\n   voice_id='Matthew'\n   ```\n\n   Specifically for comments mode (`storymode=false`):\n\n      ```.toml\n      [Reddit]\n      topn_comments=10\n      max_comment_length=300\n      min_comment_length=10\n\n      [settings]\n      total_video_duration=59\n      theme=\"dark\"\n      zoom = 1.25\n      ```\n\nAll we are left do is run:\n\n```bash\npython main.py\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnssharmaofficial%2Freddit-hole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnssharmaofficial%2Freddit-hole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnssharmaofficial%2Freddit-hole/lists"}