4discord

Discord bot which fetches random posts from any 4chan.org board!

deploy

Set up

  1. Invite 4discord to your Discord server using this invite link!
  2. Use the /4channel <channel> command to hook the bot to an existing text channel on your server. (i.e: /4channel example_channel).
    • Using /4channel requires you to have administrative permissions on the server.
  3. All set! Now you should be able to use the rest of the bot's commands on the channel you have hooked it to.

Commands

Every command for the 4discord bot

  • /4channel <channel>: Hook 4discord to an existing text channel on your server.
  • /4help: Display general help for the bot.
  • /chans <page>: Display available 4chan boards.
  • /chan <board>: Pull a random post from a 4chan board. Not providing a board will randomly pull from /b/!
  • /chan replies: Pulls some replies to the latest randomly pulled post within a 15 minutes window.

Running

Instructions on how to set the bot up internally, and on how to run it for development/testing purposes.

Prerequisites

  • Ruby 2.6.6
    • OS X: RVM is recommended over the default OS X Ruby. Here's a one-liner: \curl -sSL https://get.rvm.io | bash -s stable --ruby
  • Ensure bundler is installed: gem install bundle
  • From the project's root, run bundle install to download and install dependencies.

Launching

Background

This bot started as a small, fun project to approach, inspired by another 4chan bot. In the end I decided to carry on and keep adding features and fixing bugs, due to the massive support I received from friends and other people who enjoy reading 4chan content!

Contributing

4discord's codebase is completely open source, and is licenced under the MIT licence. Contributions are highly appreciated! You may leave a star if you would like too!

General Support

If you would like to contact the bot's support team, feel free to join our Support Discord Server and type @Support.

Data Deletion

If you are a concerned Discord server owner and would like your server's data (server id & hooked channel id and name) to be removed from our databases, forward an email to the following address with your Discord server ID and proof of ownership: jose@bgmp.cl.

In case we cannot authenticate you as the owner of said Discord server, we will reply with further instructions.

MIT Licence

Copyright (c) 2021 José Benavente

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicence, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

The only pieces of data the bot collects are:

  • Discord Server IDs
  • Discord Text Channel IDs
  • Discord Text Channel Names

4discord is proud to collect NO user data. Privacy is to be taken seriously, and the current pieces of collected data are used to enhance user experience. Server & channel ids are stored in our databases in order to allow the bot to hook onto text channels, which would not be achievable otherwise.