A modern game discovery and request management platform with IGDB integration, ROMM library support, and powerful search capabilities.
- 🔍 Advanced Search - Search 200,000+ games with filters and real-time results
- 🛡️ Content Filtering - Comprehensive ESRB rating filters, custom content blocks, and global game banning
- 🔒 Global Content Controls - System-wide content filtering that supersedes user preferences for safe environments
- 📚 ROMM Integration - Seamless integration with your ROMM game library
- 🔐 Flexible Authentication - Support for OIDC providers (Authentik, Keycloak, Auth0) and basic auth with user registration
- 🔑 API Key Management - Generate scoped API keys for programmatic access with Bearer token authentication
- 📚 Interactive API Docs - Complete OpenAPI 3.0 specification with dynamic server URLs at
/api/docs - ⚡ High Performance - Redis caching, hover preloading, and optimized data fetching
- 🎨 Modern UI - Responsive design with dark mode and smooth animations
Get running in 5 minutes with Docker:
# Clone repository
git clone https://github.com/XTREEMMAK/ggrequestz.git
cd ggrequestz
# Configure environment
cp .env.example .env
nano .env # Add your IGDB credentials and settings
# Start with Docker Compose
docker compose up -d
# Visit http://localhost:3000📖 Full Quickstart Guide | 🔧 Configuration Options
- Quickstart Guide - Get running in 5 minutes
- Configuration Guide - All configuration options
- Deployment Guide - Production deployment
- Authentication Setup - OIDC, Authentik, Basic Auth
- ROMM Integration - Connect with ROMM
- Content Filtering - User and global filtering options
- API Documentation - REST API reference
- Interactive API Docs - OpenAPI specification with live examples
Administrators can enforce system-wide content restrictions that supersede individual user preferences:
- Ban Specific Games - Remove specific games by IGDB ID from all search results and listings
- Keyword Blocking - Block games containing specific keywords in their titles
- Genre Filters - Exclude entire genres from appearing in the system
- ESRB Limits - Set maximum ESRB ratings globally
- Mature Content - Hide mature and NSFW content system-wide
Access these controls in Admin Panel → Settings → Content Filtering
Use Case: Perfect for family-friendly environments, educational institutions, or organizations requiring content compliance.
IGDB (Internet Game Database) provides the game data for G.G. Requestz. To get your API credentials:
-
Create a Twitch Developer Account
- Visit the Twitch Developer Console
- Sign in with your Twitch account (or create one if needed)
-
Register Your Application
- Click "Register Your Application"
- Fill in the required details:
- Name: G.G. Requestz (or your preferred name)
- OAuth Redirect URLs:
http://localhost:5173(for development) - Category: Application Integration
-
Get Your Credentials
- After registration, you'll receive:
- Client ID → Use as
IGDB_CLIENT_ID - Client Secret → Use as
IGDB_CLIENT_SECRET
- Client ID → Use as
- After registration, you'll receive:
-
Detailed Setup Guide
- For complete setup instructions, visit: https://api-docs.igdb.com/#getting-started
- The IGDB API uses Twitch's OAuth system for authentication
Note: These credentials are required for the application to fetch game data, search results, and cover images.
Pre-built Docker images are available:
# Pull latest image
docker pull ghcr.io/xtreemmak/ggrequestz:latest
# Pull specific version
docker pull ghcr.io/xtreemmak/ggrequestz:v1.2.3📋 v1.2.3 Release Notes: CRITICAL SECURITY FIX - Fixed API authentication bypass vulnerability. Added complete API Key Management System with scoped permissions, dynamic OpenAPI specification with environment-based URLs, admin UI improvements (sidebar fixes), and enhanced caching. All API endpoints now properly require authentication by default.
See CONTRIBUTING.md for development guidelines.
GPLv3 License - see LICENSE file for details.
