https://github.com/0xgingi/request-bot
https://github.com/0xgingi/request-bot
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/0xgingi/request-bot
- Owner: 0xGingi
- Created: 2024-10-30T12:58:01.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-10-30T13:38:41.000Z (7 months ago)
- Last Synced: 2025-02-24T07:56:36.147Z (3 months ago)
- Language: JavaScript
- Size: 8.79 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Discord Request Bot
A Discord bot that manages media requests for Jellyfin/Plex servers. Users can request movies or TV shows, and administrators can manage these requests with various status updates.
## Features
- Users can request movies/TV shows using slash commands
- Admins receive DM notifications for new requests
- Admins can update request status (in progress, fulfilled, rejected, delayed)
- Users receive DM notifications when their request status changes
- Status tracking with visual indicators (emojis)
- Request listing with status filtering
- Persistent storage of requests using JSON
- Dockerized for easy deployment
## Prerequisites
- Docker or NodeJS
- Discord Bot Token
- Discord User ID (for admin)
## Setup
1. Clone the repository:
```bash
git clone https://github.com/0xgingi/request-bot.git
cd request-bot
```
2. Create a `.env` file and add your Discord bot token and admin user ID:
```bash
TOKEN=your_discord_bot_token
ADMIN_ID=your_discord_user_id
```
3. Create an empty requests.json file:
```json
{}
```
4. Run the Docker container:
```bash
./run.sh
```
## Usage
### User Commands
- `/request ` - Request a movie or TV show
### Admin Commands
- `/status ` - Update the status of a request
- Available statuses: in progress, fulfilled, rejected, delayed
- `/list [status]` - List all requests, optionally filtered by status
- Available filters: pending, in progress, fulfilled, rejected, delayed
- `/clear ` - Clear all requests with a specific status
## Status Indicators
- ⏳ Pending
- 🔄 In Progress
- ✅ Fulfilled
- ❌ Rejected
- ⏰ Delayed
## Manual Deployment
1. Clone the repository:
```bash
git clone https://github.com/0xgingi/request-bot.git
cd request-bot
```
2. Create a `.env` file and add your Discord bot token and admin user ID:
```bash
TOKEN=your_discord_bot_token
ADMIN_ID=your_discord_user_id
```
3. Create an empty requests.json file:
```json
{}
```
4. Install Node Dependencies:
```bash
npm install
```
5. Start the bot:
```bash
npm start
```