Skip to content

ItzFlibat/JackboxRoomFinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jackbox Room Finder

This project is a TypeScript application that attempts to find active Jackbox game rooms by generating random room codes. It fetches data from the Jackbox API and provides details about the found rooms, including the game name and room features.

Warning

This project sends automated requests to Jackbox's API and excessive requests will lead to your IP being rate limited from jackboxgames.com. Use responsibly, and consider using a VPN or proxy rotation to mitigate IP rate limiting.


✨ Features

  • Generates random 4-letter room codes.
  • Checks if the generated room code is active.
  • Retrieves and displays details about the active room:
    • Game being played
    • Audience participation status
    • Password requirements status
    • Twitch locking status
    • Moderation features status
  • Provides a direct link to the game room.

📋 Prerequisites

  • Node.js 18 or higher
  • pnpm

🛠️ Installation

  1. Clone the repository:

    git clone https://github.com/ItzFlibat/JackboxRoomFinder.git
    cd JackboxRoomFinder
  2. Install dependencies:

    pnpm install

🚀 Usage

  1. Build the TypeScript code:

    pnpm run build
  2. Run the application:

    pnpm start

The script will continuously generate and test random room codes until it finds an active one, then display the room details and exit.

Alternatively, you can use Jackbox Jacker created by @coolpx.

About

Find open rooms on jackbox.tv, this was created by me for the coolpx/JackboxJacker repository.

Topics

Resources

License

Stars

Watchers

Forks

Contributors