FAQs

Something is broken. What do I do?

• First, look through the log file (using the trakts log command) to see what went wrong.
• The error/warning will mostly be near the end of the file.
• Try searching the issue tracker. Someone else is bound to have encountered this before.
• If you are unable to fix the problem, feel free to create an Issue.

How to fix a wrongly recognized show/movie?

See Metadata Remap

What happens when there is no internet connection?

• Generally, this app provides "live" updates to trakt regarding your playing status.
• However, it may happen that the app is unable to communicate with trakt servers (probably due to connection issues), and thus scrobbling updates won't be meaningful.
• For such cases, the app maintains a Backlog Cleaner, which remembers the media that you have finished watching (progress > 80%). (Storing other info like start/pause scrobbles is unnecessary)
• It will try to sync that information with trakt.tv the next time its servers are reachable.
• See backlog for configuring some parameters related to this.

How to update?

1. Stop the app using trakts stop
2. Run pipx upgrade trakt-scrobbler (if you want to install a beta version, add --pip-args='pre' at the end)
3. Start the app again using trakts start

Where is the log file/other data stored?

• Linux: ~/.local/share/trakt-scrobbler/
• Mac: ~/Library/Application Support/trakt-scrobbler/
• Windows: %APPDATA%\trakt-scrobbler\

The latest log is stored in a file named trakt_scrobbler.log; older logs can be found in the files ...log.1, ...log.2, and so on. Everything is in human readable form, so that you can figure out what data is used by the app. While submitting a bug report, be sure to include the log file contents.

How to update from pre 1.8.1 versions (those that used pipx)?

This project has moved to using uv instead of pipx for managing the installation.

Old version uninstall steps

If you followed the old Installation guide, run the following commands in a terminal/command prompt:

1. trakts stop to stop the background service.
2. pipx uninstall trakt-scrobbler

You should also uninstall pipx if you don't require it:

• osx: brew uninstall pipx
• linux/windows powershell: python3 -m pip uninstall pipx

After this, you can install the new version using steps in Installation section.

How to update from pre 1.0.0 versions?

There has been a major UX overhaul with v1.0.0, due to the introduction of the trakts command, changes in how config is stored and a much simpler way of installation. So long story short, you will have to remove the older version and re-install using the new method. In some cases, you may also have to set some configuration parameters again, if you have custom overrides - use trakts config command for that.

Old version uninstall steps

In a terminal/command prompt, run the following commands:

• Linux
  1. systemctl --user stop trakt-scrobbler to stop the background service.
  2. cd ~/.local/trakt-scrobbler/ && poetry env remove python3 to remove python environment.
  3. cd ~ && rm -rf ~/.local/trakt-scrobbler to remove installed code files.
• MacOS
  1. launchctl stop com.github.iamkroot.trakt-scrobbler to stop the background service.
  2. launchctl unload com.github.iamkroot.trakt-scrobbler to remove the service.
  3. cd ~/Library/trakt-scrobbler && poetry env remove python3 to remove python environment.
  4. cd ~ && rm -rf ~/Library/trakt-scrobbler to remove installed code files.
• Windows
  1. taskkill /im pythonw.exe to stop the background service.
  2. del "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\trakt-scrobbler.bat" to delete the autostart script.
  3. cd "%LOCALAPPDATA%\trakt-scrobbler"
  4. poetry env remove python3 to remove python environment.
  5. cd %LOCALAPPDATA%
  6. rd /S /Q "%LOCALAPPDATA%\trakt-scrobbler" to remove installed code files.

You should also uninstall poetry if you don't require it:

• osx / linux / bashonwindows: POETRY_UNINSTALL=1 curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
• windows powershell: $env:POETRY_UNINSTALL = 1; (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python

If poetry is not installed on your system, you must have used pipenv.

• For uninstallation, replace poetry env remove python3 with pipenv --rm in the steps above. To remove pipenv itself, use pip uninstall pipenv.

After this, you can install the new version using steps in Installation section.