Watcharr
Open source, self-hostable watched list for all your content (movies, tv series, anime, games) with user authentication, modern and clean UI and a very simple setup.
Top Related Projects
Add what you are watching on Plex to trakt.tv
The Free Software Media System - Server Backend & API
A Python based monitoring and tracking tool for Plex Media Server.
Quick Overview
Watcharr is an open-source, self-hosted media tracking application. It allows users to track their watched movies and TV shows, providing a personal media library management solution. The project is built with modern web technologies and emphasizes privacy and customization.
Pros
- Self-hosted solution, giving users full control over their data
- Clean and intuitive user interface
- Supports both movies and TV shows tracking
- Integrates with external APIs for metadata and information
Cons
- Requires technical knowledge to set up and maintain
- Limited community support compared to larger, commercial alternatives
- May lack some advanced features found in paid services
- Dependent on external APIs for content information, which may change or become unavailable
Getting Started
To set up Watcharr:
-
Clone the repository:
git clone https://github.com/sbondCo/Watcharr.git -
Navigate to the project directory:
cd Watcharr -
Install dependencies:
npm install -
Set up environment variables:
- Copy
.env.exampleto.env - Fill in the required API keys and database information
- Copy
-
Build and start the application:
npm run build npm start -
Access Watcharr through your web browser at
http://localhost:3000
For detailed instructions and configuration options, refer to the project's README and documentation on GitHub.
Competitor Comparisons
Add what you are watching on Plex to trakt.tv
Pros of Plex-Trakt-Scrobbler
- Seamless integration with Plex and Trakt for automatic scrobbling
- Supports multiple Plex users and servers
- More mature project with a larger user base and longer development history
Cons of Plex-Trakt-Scrobbler
- Limited to Plex and Trakt ecosystems
- Requires Plex Pass for certain features
- Less focus on modern UI and user experience
Code Comparison
Plex-Trakt-Scrobbler (Python):
def get_session(self, response):
for key, value in self.sessions.items():
if value.get('response') == response:
return key
return None
Watcharr (TypeScript):
export const getWatchProviders = async (tmdbId: number, type: string) => {
const res = await fetch(`${TMDB_API_URL}/${type}/${tmdbId}/watch/providers?api_key=${TMDB_API_KEY}`);
const data = await res.json();
return data.results;
};
The code snippets show different languages and functionalities. Plex-Trakt-Scrobbler uses Python for session management, while Watcharr uses TypeScript for API interactions with TMDB.
Watcharr focuses on providing a modern, self-hosted alternative to Trakt with a clean UI and support for multiple tracking sources. It's newer and may have fewer features but offers more flexibility in terms of data sources and self-hosting options.
The Free Software Media System - Server Backend & API
Pros of Jellyfin
- More mature and feature-rich media server solution
- Larger community and active development
- Supports a wide range of client devices and platforms
Cons of Jellyfin
- More complex setup and configuration
- Heavier resource usage due to its comprehensive feature set
- Steeper learning curve for new users
Code Comparison
Jellyfin (C#):
public class MediaBrowser : IDisposable
{
private readonly ILogger<MediaBrowser> _logger;
private readonly ILibraryManager _libraryManager;
// ...
}
Watcharr (TypeScript):
export default class MediaManager {
private readonly logger: Logger;
private readonly library: LibraryService;
// ...
}
Summary
Jellyfin is a comprehensive media server solution with a large community and extensive features, while Watcharr appears to be a newer, potentially lighter-weight alternative. Jellyfin offers broader device support and more advanced functionality but may require more resources and setup time. Watcharr might be simpler to use but may lack some of the advanced features found in Jellyfin. The code comparison shows similar structure in managing media libraries, with Jellyfin using C# and Watcharr using TypeScript.
A Python based monitoring and tracking tool for Plex Media Server.
Pros of Tautulli
- More mature and feature-rich project with extensive Plex integration
- Provides detailed analytics and monitoring for Plex Media Server
- Supports notifications and custom scripts for various events
Cons of Tautulli
- Focused solely on Plex, limiting its use for other media servers
- More complex setup and configuration process
- Requires a separate installation alongside Plex
Code Comparison
Tautulli (Python):
def get_stream_details(self, row):
stream_count = []
for item in row['session_key'].split(','):
if item:
stream_count.append(item)
stream_count = len(stream_count)
return stream_count
Watcharr (JavaScript):
export const getWatchProviders = async (tmdbId, type) => {
const res = await fetch(`${TMDB_API_URL}/${type}/${tmdbId}/watch/providers?api_key=${TMDB_API_KEY}`);
const data = await res.json();
return data.results;
};
While both projects are related to media management, they serve different purposes. Tautulli is a comprehensive monitoring and analytics tool for Plex, while Watcharr appears to be a simpler media tracking application. The code snippets reflect their different focuses, with Tautulli handling stream details and Watcharr fetching watch provider information.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
Watcharr

I'm your new easily self-hosted content watched list. The place you store your watched (or watching, planned, etc) movies and tv shows (and anime), rate them and track their status.
With some extra configuration I can also track your video games.
I am built with Go and Svelte(Kit).
Feel free to abuse this demo instance (nicely), which runs on the latest dev build (there may be bugs, as new features are tested on here too): https://beta.watcharr.app/
Track progress for the next version.
Contents
Screenshots
| Homepage | Watched Show Hover |
|---|---|
![]() | ![]() |
| Watched Show Status Change | Movie Details |
|---|---|
![]() | ![]() |
| User Profile | Discover |
|---|---|
![]() | ![]() |
| Dark Homepage | Dark Content Details |
|---|---|
![]() | ![]() |
Set Up
Checkout our documentation for an up to date guide on setup! If you hate manuals, but love docker, this docker-compose.yml file is your friend.
Community Made Tools
Third-party tools made by the community for enhancing your Watcharr experience!
- Kodi Plugin by airdogvan for automatically tracking your watched shows/movies.
Thanks to anyone that has made a script or tool for Watcharr. Feel free to add your own to the list if you have one!
Note: I cannot provide any assurances for these tools or stay on top of them (code review, etc), if you have any problems please open an issue in the project for the tool so that they can stay organized.
Getting Help
If something isn't working for you or you are stuck, creating an issue is the best way to get help! Every type of issue is accepted, so don't be afraid to ask anything!
You can also join our space on Matrix for support.
Contributing
Please continue to our contributing guide.
Top Related Projects
Add what you are watching on Plex to trakt.tv
The Free Software Media System - Server Backend & API
A Python based monitoring and tracking tool for Plex Media Server.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot






