# 4chan
The one stop solution for checking 4chan with Discord!

It allows for grabbing random posts from any board, formatting a post as a Discord embed, or even browsing a board with a clean and simple UI!

### Features
- Gets random posts from any 4chan board!
- Neatly formats 4chan posts as embeds
- User friendly and easy to use
- Allows you to browse 4chan boards within Discord!
- Subscribe to boards and get a random post at a set interval
- Customizable server configuration
- Allows users to remove posts if they are too edgy (can be disabled)
- NSFW boards are restricted to NSFW channels on Discord

### How to use
For help or a list of commands, type `/4chan help`.

To get a random post off /g/, type `/random`.

To get a random post off another board, type `/random <board>` (e.g. `/random /v/`).

To browse /g/, type `/browse`.

To browse the replies of thread 842934822 on /b/, type `/browse /b/ 842934822`.

### Commands
- **/4chan help**: Lists all commands and their usage.
- **/4chan info**: Gets information about bot version and system.
- **/random [board]**: Gets a random post from the default board or a specified board.
- **/boards**: Shows a list of available boards which you can use.
- **/post &lt;id&gt; &lt;board&gt;**: Gets the OP post of the thread with the given ID from the given board.
- **/browse [board] [id]**: Browses the given board, or the server default board. Optionally finds the thread matching the given ID.
- **/config**: Allows you to configure the behaviour of the bot for your server (available to server admins only). For a list of config options [please click here](https://github.com/Romejanic/4chan-Discord-Bot/blob/master/CONFIG.md).

### Permissions
Most commands are accessible to all users of your server, in any text channel (unless restricted using the /config command).

Removing posts: Only the user who sent the command or a user with the `Manage Messages` permission can remove posts by pressing the 'Remove' button. Removing posts is disabled in DMs.

/config command: Only users with the `Manage Server` permission can use this command. This command is also disabled in DMs.

### Reporting Bugs
Please report bugs in the [Issues](https://github.com/Romejanic/4chan-Discord-Bot/issues/new/choose) tab of the GitHub page or on the #4chan-bug-reports channel of the [support server](https://discord.gg/fawJ2dTxFS). If you are a developer and would like to try and fix some of these bugs, you may fork the repository and open a pull request to help.

4chan

All in one 4chan bot. Get random posts, browse and subscribe to boards.

التصويت لـ4chan

هل ترغب في دعمنا؟