🎬 TraktDiscordPresence: Your Binge-Watching Broadcaster! 🎭

Because your friends deserve to know you're on your 17th consecutive hour of that obscure Danish crime drama!

---

🌟 Welcome to the Couch Potato's Dream App!

TraktDiscordPresence is the missing link between your Trakt.tv account and Discord status. Now, your friends can marvel at your impressive TV show marathon skills or judge your questionable movie choices - all in real-time! Whether you're diving into a new series, revisiting a classic, or just leaving Netflix running in the background while you nap, TraktDiscordPresence has got you covered.

🎭 Features That'll Make You the Star of Discord

🔄 Real-Time Sync Your Discord status updates faster than you can say "Just one more episode"!	🎨 Rich Presence Display Show off what you're watching with style - movie posters included!
📊 Smart Progress Tracking Let everyone know you're 5 hours into your 12-hour binge session!	🛠️ Easy Setup & Configuration Get up and running quicker than deciding what to watch next!

🚀 Requirements

• Bun
• Trakt.tv account
• Discord account

🛠️ Installation & Setup

1. Download the latest release.

2. Extract and move the files to your desired location.

3. Install Bun:

   • Mac/Linux:

     curl -fsSL https://bun.sh/install | bash

   • Windows:

     powershell -c "irm bun.sh/install.ps1 | iex"

4. Navigate to your project folder:

   cd /path/to/your/extracted/source

5. Install dependencies:

   bun install

⚙️ App Configuration

1. Create a new Trakt application

   • Name it Discord
   • Set Redirect uri as urn:ietf:wg:oauth:2.0:oob

2. Create a new Discord application

   • Name it Trakt
   • Add trakt.png from the images folder as the app icon and cover image in Rich Presence section
   • Upload the remaining images from the images folder

3. Rename .env.example to .env and input the information from steps 1 and 2

🎬 Usage

1. Start the application:

   bun start

2. The authentication process will run on first launch:

   • The application will provide a link in the terminal
   • Copy the code displayed in the terminal
   • Open the provided link in your browser
   • Paste the copied code into the website to authorize the application

3. After initial setup, run bun start again to launch the program.

Upon successful setup, your console output should resemble this:

• Console Output
  
• Discord Status
  

📊 Logging

The application provides real-time updates on your watching status directly in the console.

🤝 Contributing

We welcome contributions to TraktDiscordPresence. If you'd like to contribute, please follow these steps:

1. Fork the repository
2. Create a new branch for your feature or bug fix:

   git checkout -b feature/your-feature-name

3. Make your changes and commit them with a clear, descriptive message:

   git commit -m 'Add feature: brief description of your changes'

4. Push your changes to your fork:

   git push origin feature/your-feature-name

5. Open a Pull Request against the main repository's main branch

Please ensure your code adheres to the project's coding standards and include tests for new features or bug fixes where applicable. We appreciate detailed descriptions in your Pull Request to help with the review process.

📜 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details. (It's mostly "Share the love, and keep it open!")

🙏 Wall of Fame

• Trakt.tv for keeping track of our questionable viewing habits
• Discord for giving us a place to show off said habits
• All our contributors, supporters, and that one guy who starred the repo by accident

📬 Join the Watch Party

Got questions? Want to debate the best TV shows? Join our Discord server - it's like a virtual living room, but with less fighting over the remote!

---

💻 Crafted with ❤️ (and many snacks) by Valhalla-Development

🐛 Spotted an issue? | 💡 Got an idea? | 🤔 Need a viewing guide?

🔝 Back to Top (Time for a Snack Break)