Skip to content

Set your Discord presence according to what you are watching on Trakt

License

Notifications You must be signed in to change notification settings

Valhalla-Development/TraktDiscordPresence

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TraktDiscordPresence Banner

🎬 TraktDiscordPresence: Your Binge-Watching Broadcaster! 🎭

Discord Stars Forks Issues License
Codacy Powered by Trakt Made with TypeScript

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

🛠️ Installation & Setup

  1. Download the latest release.

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

  3. Install Node.js (LTS version recommended).

  4. Ensure Node is added to your system's PATH.

  5. Install Yarn globally:

    npm install --global yarn
  6. Navigate to your project folder:

    cd /path/to/your/extracted/source
  7. Install dependencies:

    yarn 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

🎬 Usage

  1. Start the application:

    yarn start
  2. When prompted, enter your Trakt Client ID, Trakt Client Secret, and Discord Client ID.

  3. Follow the provided URL to authorize your Trakt account. Grant access and enter the received code in the terminal.

  4. After initial setup, run yarn start again to launch the program.

Upon successful setup, your console output should resemble this:

  • Console Output
    Example Output
  • Discord Status
    Discord Example

📊 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!