leepeuker / movary

Self hosted web app to track and rate your watched movies

Movary

The central hub to track, rate and explore your movie watch history

Website • Installation • Docs • Api • Demo

Movary is a free and open source web application to track, rate and explore your movie watch history. You can host it for yourself and others. It offers detailed statistics, third-party integrations for importing and exporting your history from platforms like Trakt, Letterboxd, or Netflix, automated play tracking for Plex, Jellyfin or Emby and much more.

Disclaimer: This project is still in an experimental (but usable) state. There are plans to add more and improve existing features before creating the 1.0 Release, which can lead to sudden breaking changes from time to time, so keep the release notes in mind when updating until then.

Features

• Movie watch history: Collect and manage your watch history and ratings
• Statistics: Analyze your movie watching behavior and history, like e.g. most watched actors/directors/genres/languages/years
• Customization: You decide how your dashboard should look like, what format to use when displaying dates and more
• Third party integrations: Import and export your history and ratings from/to platforms like Trakt, Letterboxd, or Netflix
• Scrobbler: Automatically add new plays and ratings from Plex, Jellyfin or Emby
• Own your personal data: Users can decide who can see their data and export/import/delete the data and their accounts at any time
• Locally stored metadata: Using e.g. themoviedb.org and imdb as sources, all metadata movary uses for your history entries can be stored locally
• PWA: Can be installed as a smartphone app (How to install PWAs in chrome)
• User-management: Use Movary alone or with others
• Completely free, no ads, no tracking and open source! :)

Demo

A demo installation can be found here (User: [email protected] Password:testUser).

Documentation

The documentation for the latest release is located here. Please report missing or wrong information.

Support

• Please report bugs and request features/changes via Github issues
• Ask for help or discuss related topics via Github discussions
• Join our Discord server

Contributors

• @leepeuker as Lee Peuker
• @JVT038 as JVT038
• @pbogre as Pietro Bonaldo Gregori

movary's Issues

Add info when update is available

Add info when update is available on the app settings page.

Graph for rating distribution

Show a graph about the distribution of given ratings.

Better secure login

Currently there is no protection against stuff like brute force attacks.

Proposal:

• after 3 failed login attempts in 24h display a captcha
  • for captcha use https://github.com/Gregwar/Captcha
• add min length of 8 characters as requirement to password

Privatize plex webhook url

Currently there is a static webhook url /plex. This can lead to abuse.

Change it so that the webhook url contains a unique string (which you can regenerate on demand).

Verify trakt credentials on save

Cannot scrape all rating vote counts from imdb

Examples:

• https://www.imdb.com/title/tt0110912/
• https://www.imdb.com/title/tt0109830/

It seems to affect movies with a M in the voting count

Add auto deployment on new release for demo deployment

Add type filter to job queue page

Add a dropdown with available job types to filter results by

Add age to person page

Letterboxd watchlist sync

Add way to sync watches from letterboxd to application

Add "Remember me" option for login

Change table on job queue page

• remove id
• switch user and type

Improve user management via cli

• add cli command to delete user
• add cli command to list users
• combine update/change user commands into one update command
• add option to disable password changes
• add option to disable account deletion

Add default date when logging movie

Add top person filters

Add gender filter to top actor/directors pages

Add status message after logging movie

If movie was successfully added display a success message and an error message if it failed.

Extend movies page filter options

• add sorting by IMDb and tmdb ratings
• add rating filter

Add imbd rating

Add imdb rating for movies

TMDB sync: Production company origin country not updated

https://www.themoviedb.org/company/2699-caviar/changes
This company had its origin country changed, which lead to broken sync process.

This could maybe be solved in the future by implementing #85

The sync will than not be able to update the temporarily broken movie at first, but should be able to do it later, if it is just skipped and processed later when the company was updated while processing the attached movie.

Save movie posters locally

Sometime there can be issues with the directly from TMDB api requested images in the frontend, e.g. when requesting a lot of them at once.

Movie posters should be saved and used locally when a movie is added.

Change password via web UI

Currently you can change the password only via cli.

Add a way to change it via web UI.

Improve setup: Create initial user via web UI

Currently when setting up the app, you have to create the first user via cli.

The app should provide the possibility to create the initial user via web UI

Add movary to plex rating sync

Add export data to trakt.tv option

Currently you can only import data from trakt. You should be able to export the data too.

Add options for date formats in UI

Currently there is only support for one static date format. The user should be given a choice which format is used.

Add privacy option for user

Currently the history, ratings, etc. of a user are publicly available. Add option for user to disable public access (which should be the new default).

Todo:

• add new user attribute flag is_private
• add way to set flag via settings page
• evaluate flag when accessing user specific page

Display current release version

Export personal data

Add a way to export all movie watch dates and rating as a csv

Fix general settings update error when core account changes are disabled

Should be enough to just enable the username input field

TMDB sync: Errors on one movie stops sync process permanently until movie is fixed

If a movie has a persistent issue during the tmdb sync process, it will make syncing data in general impossible, because it will always fail and stop add the movie with the issue.

Broken movies should be ignored and not kill the sync process for all movies

Better UI for settings page

The UI for the settings page grew into something pretty ugly. Should be improved

Inform user about job processing outcome

Currently a user does not know if a scheduled job was processed successfully, failed or processed at all.

Todo:

• add dedicated job page for logged in users
• list all jobs and their status (waiting, processing, succeeded, failed) for user
• add possibility to delete jobs (optional, could be moved into a separate issue)

Add option to select used image sizes

Currently the image sizes used for tmdb images is hardcodes. Make this configurable.

Add cli command to clean up locally cached image files

Add "password forgotten" feature

Currently the only way to help a user who has forgotten his/her password is to set a new password via cli command.

Todo:

• add smtp mailer logic
• add "Forgot Password" button to login page
• create "Password reset" page, only with valid token
• send link to password reset page on "Forgot Password" button press
  • create and store password reset token in backend
  • must have an expiration time
• Extend users setttings page with new section "Password resets" with two buttons: "List Resets" and "Create Resets"

Handle tmdb sync on new data import

When importing data with new movies (movary first party import), a lot of tmdb meta data is missing.

Suggestions:

• sync immediately in import
• schedule events to sync

Letterboxd rating sync

Add way to sync letterboxd ratings with local data.

Cache tmdb iso 693 language mapping locally

Todo:

• download ISO mapping from tmdb api
• store in database
• use iso mapping stored in database
• ad mechanism to refresh ISO mapping every few weeks or so

Add option to edit watch dates

Current workflow to change a wrong watch date:

• delete wrong watch date on movie page
• add new watch date with correct date on log movie page

Suggestion:

• edit wrong watch date on movie page

Plex: Use webhook on rating updates

When a rating is updated in plex a user should have the option to enable a sync of this rating with movary.

Fix broken top person images

Image edges should not be round

Make what plex tracks configurable per user

Currently it is an application wide setting what plex webhooks should be trakt.

Make this configurable per user and the UI on the plex settings page (simple checkboxes should be enough).

Account settings page shortly displayed without css on page load

This seems only to happen via Firefox. Maybe this could fix it: https://stackoverflow.com/questions/21147149/flash-of-unstyled-content-fouc-in-firefox-only-is-ff-slow-renderer/57888310#57888310

Add option to web UI to instant refresh imdb rating of movie

Improve UX for logging new movie

Current steps to log a movie:

• press menu icon -> opens menu dropdown
• press "Log movie" -> loads log movie page
• enter search term -> loads log movie page with search results

Better:

• press log movie icon -> opens movie search modal
• enter search term in modal -> loads log movie page with search results

Add job queue cleanup

Add cli command and frontend button to remove done jobs from queue

Make trakt api keys configureable per user

Currently the trakt api keys used for syncing have to be supplied via ENV (makes not much sense anymore with the multi user setup)

Todo:

• remove trakt keys from env
• store user trakt api keys in database next to the rest of the user data and use them when syncing user data with trakt

Use username in user specific url routes instead of id

Currently the user id is used in the url route for user specific pages, e.g. /1/dashboard
Instead if the user id the username should be used.

Todo:

• Set username to user id as default
• only allow alphanumeric characters in username
• use username in route instead of id

Followup: Add way to change username to settings page

Write php logs to container

Currently the logs are only written into a file in the container. Add the logs to the container too

Add filterable movie view

Add a new view which displays all uniquely watched movies with the possibility to filter (e.g. by ratings or release year)