{"id":15445270,"url":"https://github.com/bgmp/4discord","last_synced_at":"2025-04-19T20:41:41.983Z","repository":{"id":161012194,"uuid":"549893979","full_name":"BGMP/4discord","owner":"BGMP","description":"4chan Discord Bot written in Ruby","archived":false,"fork":false,"pushed_at":"2023-03-25T14:10:27.000Z","size":687,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T13:11:18.714Z","etag":null,"topics":["4chan","discordrb","nsfw"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/BGMP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.YML","license":null,"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},"funding":{"github":"BGMP"}},"created_at":"2022-10-11T22:47:01.000Z","updated_at":"2024-09-19T10:42:43.000Z","dependencies_parsed_at":"2023-09-16T17:41:18.049Z","dependency_job_id":null,"html_url":"https://github.com/BGMP/4discord","commit_stats":{"total_commits":12,"total_committers":2,"mean_commits":6.0,"dds":"0.41666666666666663","last_synced_commit":"64a8f19ef8de34d72a56b3a65a022853dcf5169c"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BGMP%2F4discord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BGMP%2F4discord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BGMP%2F4discord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BGMP%2F4discord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BGMP","download_url":"https://codeload.github.com/BGMP/4discord/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249795203,"owners_count":21326777,"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":["4chan","discordrb","nsfw"],"created_at":"2024-10-01T19:44:30.191Z","updated_at":"2025-04-19T20:41:41.961Z","avatar_url":"https://github.com/BGMP.png","language":"Ruby","funding_links":["https://github.com/sponsors/BGMP"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg height=\"200\" width=\"200\" src=\"https://raw.githubusercontent.com/BGMP/4discord/master/assets/logo.png\"  alt=\"\"/\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e4discord\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eDiscord bot which fetches random posts from any \u003ca href=\"https://4chan.org/\" target=\"_blank\"\u003e4chan.org\u003c/a\u003e board!\u003c/h4\u003e\n\n\n### What is 4chan?\nFrom [4chan.org](https://4chan.org)'s landing page:\n\n\"4chan is a simple image-based bulletin board where anyone can post comments and share images. There are boards dedicated to a variety of topics, from Japanese animation and culture to videogames, music, and photography. Users do not need to register an account before participating in the community. Feel free to click on a board below that interests you and jump right in!\n\nBe sure to familiarize yourself with the [Rules](https://4chan.org/rules) before posting, and read the [FAQ](https://4chan.org/faq) if you wish to learn more about how to use the site.\"\n\n### What is 4discord/4cord?\nFormerly **4discord**, now just **4cord**. Browse 4chan from the comfort of your Discord server, pull from any of its boards and explore what the anonymous internet has to say using simple slash commands on your text channels of choice.\n\n### Set up\n  1. Invite **4discord** to your Discord server using \n[this invite link](https://discord.com/api/oauth2/authorize?client_id=780529113118539798\u0026permissions=2048\u0026scope=bot)!\n  2. On your Discord server, you may configure the bot at Server Settings » Integrations.\n  3. Make sure the channel where you want to use the bot at is marked as **NSFW** (Age Restricted Channel).\n  4. All set! Now you should be able to use the bot on the channels you have defined.\n\n### Commands\nThe bot uses slash commands as of its rewrite. Make sure to select the commands you want to execute and then provide\nthe arguments as Discord requests them via visual queues (use the Tab key to auto-complete).\n\nThe following list contains all available commands:\n\n  * `/chan [board]`: Pull a random post from a 4chan board. Not providing a board will randomly pull from /o/!\n  * `/chans [page]`: Display available 4chan boards.\n  * `/4help`: Display general help for the bot.\n\n### Running\nInstructions on how to set the bot up internally, and on how to run it for development/testing purposes.\n\n#### Prerequisites\n* [Ruby 2.7.3](https://www.ruby-lang.org/)\n  * OS X: [RVM](http://rvm.io) is recommended over the default OS X Ruby. Here's a one-liner:\n`\\curl -sSL https://get.rvm.io | bash -s stable --ruby`\n* Ensure bundler is installed: `gem install bundle`\n* From the project's root, run `bundle install` to download and install dependencies.\n\n#### Launching\n* Create a bot application on your [Discord applications portal](https://discord.com/developers/applications).\n* Rename the [config.yml.secrets](https://github.com/BGMP/4discord/blob/master/config/config.yml.secrets) to `config.yml`.\n* Complete the fields in `config.yml` with your bot's client id and token.\n* Run the [4discord.rb](https://github.com/BGMP/4discord/blob/master/src/4discord.rb) file. (`ruby 4discord.rb`)\n\n### Data Collection\n4discord is proud to collect **NO** data. With the migration to slash commands and other features introduced by Discord\nover time, there is no longer a need to store server IDs, channel IDs, or channel names like the bot used to do in the\npast. \n\n### Background\nThis bot started as a small, fun project to approach, inspired by another\n[4chan bot](https://github.com/Romejanic/4chan-Discord-Bot). In the end I decided to carry on and keep adding\nfeatures and fixing bugs, due to the massive support I received from friends and other people who enjoy reading 4chan\ncontent!\n\nAs of October, 2022 the bot has been rewritten to support the newly introduced slash commands, and to comply with the\nnew limitations imposed by Discord such as Message Content being now a privileged intent. The old repository has been\narchived and made private. All further development will be conducted in this repository instead.\n\n### Disclaimer\nAny contributors to 4discord's codebase are not responsible for anything you may pull from 4chan.org using the 4discord\nbot. This bot is provided as a free resource open for anybody to use, therefore it is every server owner's\nresponsibility to moderate what the bot may pull from the site and post on their text channels.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgmp%2F4discord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbgmp%2F4discord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgmp%2F4discord/lists"}