{"id":18103122,"url":"https://github.com/topi314/reddit-discord-bot","last_synced_at":"2026-03-10T19:30:44.610Z","repository":{"id":42006976,"uuid":"370518566","full_name":"topi314/Reddit-Discord-Bot","owner":"topi314","description":"A Discord Bot to deliver Reddit posts into your server","archived":false,"fork":false,"pushed_at":"2025-01-28T23:58:16.000Z","size":542,"stargazers_count":38,"open_issues_count":0,"forks_count":7,"subscribers_count":5,"default_branch":"v2","last_synced_at":"2025-04-10T11:39:48.082Z","etag":null,"topics":["bot","discord","discord-bot","reddit"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/topi314.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}},"created_at":"2021-05-25T00:21:57.000Z","updated_at":"2025-04-05T20:48:54.000Z","dependencies_parsed_at":"2022-08-12T02:10:35.740Z","dependency_job_id":"2a513438-d73d-49a7-8204-8fbadecf50da","html_url":"https://github.com/topi314/Reddit-Discord-Bot","commit_stats":null,"previous_names":["topi314/reddit-discord-bot","topisenpai/reddit-discord-bot"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topi314%2FReddit-Discord-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topi314%2FReddit-Discord-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topi314%2FReddit-Discord-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topi314%2FReddit-Discord-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/topi314","download_url":"https://codeload.github.com/topi314/Reddit-Discord-Bot/tar.gz/refs/heads/v2","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248766728,"owners_count":21158301,"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":["bot","discord","discord-bot","reddit"],"created_at":"2024-10-31T22:10:23.712Z","updated_at":"2026-03-10T19:30:44.573Z","avatar_url":"https://github.com/topi314.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reddit-Discord-Bot\n\nSimple webhook based bot delivering Reddit posts into your Discord Server\n\n\u003cimg src=\".github/embed-preview.png\" alt=\"embed reddit post\"\u003e\n\u003cimg src=\".github/text-preview.png\" alt=\"text reddit post\"\u003e\n\nThe bot does not require any permissions and can't do anything in your Discord. With that it's safe to use!\n\n\u003cdetails\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [Public Bot](#public-bot)\n- [Usage](#usage)\n\t- [Add Subreddit](#add-subreddit)\n\t- [Remove Subreddit](#remove-subreddit)\n\t- [List Subreddits](#list-subreddits)\n- [Self-hosted](#self-hosted)\n\t- [Binary](#binary)\n\t- [Docker-Compose](#docker-compose)\n- [Help](#help)\n- [License](#license)\n- [Contributing](#contributing)\n- [Contact](#contact)\n\n\u003c/details\u003e\n\n## Public Bot\n\nInvite the bot [here](https://discord.com/oauth2/authorize?client_id=846396249241288796\u0026scope=applications.commands)\n\n## Usage\n\n### Add Subreddit\n\nTo add a new subreddit run\n\n```bash\n/reddit add \u003csubreddit-name\u003e (new/hot/top/rising) (embed/text/link) (role) (proxy)\n```\n\nand click the returned link\n\nselect the server \u0026 channel in the discord popup \u0026 hit okay that's all!\n\n### Update Subreddit\n\nTo update a subreddit run\n\n```bash\n/reddit update \u003csubreddit-name\u003e (new/hot/top/rising) (embed/text/link) (role) (proxy)\n```\n\n### Remove Subreddit\n\nTo remove a subreddit subscriptions run\n\n```bash\n/reddit remove \u003csubreddit-name\u003e\n```\n\nand remove the bot under `Server Settings \u003e Integrations` or just delete the webhook under `Channel Settings \u003e Integrations \u003e Webhooks`\n\n### List Subreddits\n\nTo list all subreddit subscriptions run\n\n```bash\n/reddit list (channel)\n```\n\n## Self-hosted\n\nReddit-Discord-Bot is now super easy to self-host. You can either use the docker image or build a binary yourself.\n\nBefore you can run the bot you need to create a config file. You can find an example [here](/config.example.yml)\n\nYou also need a discord bot token, which you can get from [here](https://discord.com/developers/applications).\n\nLastly you need to create a reddit app which can be done [here](https://www.reddit.com/prefs/apps/).\n\nThe bot requires a database, which can either be `SQLite` or `PostgreSQL`. Just select the one you want to use in the config file.\n\n### Binary\n\nPrerequisites:\n\n- [Go](https://golang.org/doc/install)\n- [Git](https://git-scm.com/downloads)\n- [PostgreSQL](https://www.postgresql.org/download/) (optional)\n\n```bash\n$ git clone git@github.com:topi314/Reddit-Discord-Bot.git\n$ cd Reddit-Discord-Bot\n$ go build -o reddit-discord-bot github.com/topi314/reddit-discord-bot/v2\n```\n\nYou can now run the bot with\n\n```bash\n$ ./reddit-discord-bot -config config.yml\n```\n\n### Docker-Compose\n\nDocker-Compose is the easiest way to run the bot and is also the way I recommend.\n\n#### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/)\n- [Docker-Compose](https://docs.docker.com/compose/install/)\n- [PostgreSQL](https://www.postgresql.org/download/) (optional)\n\n#### Setup\n\nCreate a `docker-compose.yml` file and paste the following into it\n\n```yaml\nversion: \"3.8\"\n\nservices:\n  reddit-bot:\n    image: ghcr.io/topi314/reddit-discord-bot:v2\n    container_name: reddit-bot\n    restart: unless-stopped\n    volumes:\n      - ./config.yml:/var/lib/reddit-discord-bot/config.yml\n      - ./database.db:/var/lib/reddit-discord-bot/database.db\n```\n\n#### Configuration\n\nCreate a `config.yml` file and paste [this](/config.example.yml) into it.\n\nFill in the required fields, and you are good to go!\n\nAlso create a `database.db` file if you want to use SQLite.\n\n#### Running\n\nYou can now run the bot with\n\n```bash\n$ docker-compose up -d\n```\n\n#### Updating\n\nTo update the bot just run\n\n```bash\n$ docker-compose pull\n$ docker-compose up -d\n```\n\n#### Stopping\n\nTo stop the bot run\n\n```bash\n$ docker-compose down\n```\n\n# Help\n\nIf you encounter any problems feel free to open an issue or reach out to me(`toπ#3141`) via discord [here](https://discord.gg/RKM92xXu4Y)\n\n# License\n\nReddit-Discord-Bot is licensed under the [Apache License 2.0](LICENSE).\n\n# Contributing\n\nContributions are always welcome! Just open a pull request or discussion and I will take a look at it.\n\n## Contact\n\n- [Discord](https://discord.gg/sD3ABd5)\n- [Twitter](https://twitter.com/topi314)\n- [Email](mailto:git@topi.wtf)\n- [Matrix](https://matrix.to/#/@topi:topi.wtf)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftopi314%2Freddit-discord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftopi314%2Freddit-discord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftopi314%2Freddit-discord-bot/lists"}