# Trakt Scrobbler
A trakt.tv scrobbler for your computer.
## What is Trakt?
Automatically scrobble TV show episodes and movies you are watching to [Trakt.tv](https://trakt.tv)! It is a website that keeps a history of everything you've watched!
## What is trakt-scrobbler?
`trakt-scrobbler` is an application that runs in the background and monitors your media players for any new activity. When it detects some file being played, it determines the media info (such as name of the movie/show, episode number, etc.) and sends this to [trakt.tv](https://trakt.tv) servers, so that it can be marked as "Currently Watching" on your profile. No manual intervention required!
## Features
* Full featured [command line interface](https://github.com/iamkroot/trakt-scrobbler/wiki/trakts-CLI-Reference) to control the service. Just run `trakts`.
* Automatic media info extraction using [guessit](https://github.com/guessit-io/guessit).
* Scrobbling is independent of the player(s) where the media is played. Support for new players can thus be easily added.
* Currently supports:
* [VLC](https://www.videolan.org/vlc/) (via web interface)
* [Plex](https://www.plex.tv) (doesn't require Plex Pass)
* [MPV](https://mpv.io) (via IPC server)
* [MPC-BE](https://sourceforge.net/projects/mpcbe/)/[MPC-HC](https://mpc-hc.org) (via web interface).
* **Folder whitelisting:** Only media files from subdirectories of these folders are synced with trakt.
* Optionally, you can receive a quick notification that the media start/pause/stop activity has been scrobbled.
* For cases when it misidentifies the files, you can specify a regex to manually extract the necessary details.
* Proxy support: Optionally specify a proxy server to handle all communication with trakt servers!
## Getting Started
Head over to the [wiki](https://github.com/iamkroot/trakt-scrobbler/wiki) for further details.
## Contributing
Feel free to create a new issue in case you find a bug/want to have a feature added. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more details. Proper PRs are welcome.
## Acknowledgements
* Inspired from [TraktForVLC](https://github.com/XaF/TraktForVLC)
* [mpv-trakt-sync-daemon](https://github.com/stareInTheAir/mpv-trakt-sync-daemon) was a huge help in making the mpv monitor
Raw data
{
"_id": null,
"home_page": "https://github.com/iamkroot/trakt-scrobbler",
"name": "trakt-scrobbler",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "trakt,scrobbler",
"author": "iamkroot",
"author_email": "kroot.patel@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/76/e0/5c6f8e4126ba3d0cd7f32c15142ebb78052b63481803b69436ca7c0ca7d8/trakt_scrobbler-1.6.3.tar.gz",
"platform": null,
"description": "# Trakt Scrobbler\n\nA trakt.tv scrobbler for your computer.\n\n## What is Trakt?\n\nAutomatically scrobble TV show episodes and movies you are watching to [Trakt.tv](https://trakt.tv)! It is a website that keeps a history of everything you've watched!\n\n## What is trakt-scrobbler?\n\n`trakt-scrobbler` is an application that runs in the background and monitors your media players for any new activity. When it detects some file being played, it determines the media info (such as name of the movie/show, episode number, etc.) and sends this to [trakt.tv](https://trakt.tv) servers, so that it can be marked as \"Currently Watching\" on your profile. No manual intervention required!\n\n## Features\n\n* Full featured [command line interface](https://github.com/iamkroot/trakt-scrobbler/wiki/trakts-CLI-Reference) to control the service. Just run `trakts`.\n* Automatic media info extraction using [guessit](https://github.com/guessit-io/guessit).\n* Scrobbling is independent of the player(s) where the media is played. Support for new players can thus be easily added.\n* Currently supports:\n * [VLC](https://www.videolan.org/vlc/) (via web interface)\n * [Plex](https://www.plex.tv) (doesn't require Plex Pass)\n * [MPV](https://mpv.io) (via IPC server)\n * [MPC-BE](https://sourceforge.net/projects/mpcbe/)/[MPC-HC](https://mpc-hc.org) (via web interface).\n* **Folder whitelisting:** Only media files from subdirectories of these folders are synced with trakt.\n* Optionally, you can receive a quick notification that the media start/pause/stop activity has been scrobbled.\n* For cases when it misidentifies the files, you can specify a regex to manually extract the necessary details.\n* Proxy support: Optionally specify a proxy server to handle all communication with trakt servers!\n\n## Getting Started\nHead over to the [wiki](https://github.com/iamkroot/trakt-scrobbler/wiki) for further details.\n\n## Contributing\n\nFeel free to create a new issue in case you find a bug/want to have a feature added. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more details. Proper PRs are welcome.\n\n## Acknowledgements\n\n* Inspired from [TraktForVLC](https://github.com/XaF/TraktForVLC)\n* [mpv-trakt-sync-daemon](https://github.com/stareInTheAir/mpv-trakt-sync-daemon) was a huge help in making the mpv monitor\n",
"bugtrack_url": null,
"license": "GPL-2.0-only",
"summary": "Scrobbler for trakt.tv that supports VLC, Plex, MPC-HC, and MPV",
"version": "1.6.3",
"split_keywords": [
"trakt",
"scrobbler"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9a3c1a9308410dc2146b7c8e668c41aa11f711ceb9ea8716045d6af4afa43446",
"md5": "3d83f1aff64000c02986ed32d1fc8deb",
"sha256": "213bd0ccca0b0c6ace75a1ff25764dffcc8f7c2b2c975c9516c10ab6f3068b40"
},
"downloads": -1,
"filename": "trakt_scrobbler-1.6.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d83f1aff64000c02986ed32d1fc8deb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 63472,
"upload_time": "2023-01-06T02:16:19",
"upload_time_iso_8601": "2023-01-06T02:16:19.208049Z",
"url": "https://files.pythonhosted.org/packages/9a/3c/1a9308410dc2146b7c8e668c41aa11f711ceb9ea8716045d6af4afa43446/trakt_scrobbler-1.6.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "76e05c6f8e4126ba3d0cd7f32c15142ebb78052b63481803b69436ca7c0ca7d8",
"md5": "1493e93079085ec839458e65204753db",
"sha256": "802f97dc969f8ee3107a0f957d1c9ba236037da42628e05431e11c1e06b32234"
},
"downloads": -1,
"filename": "trakt_scrobbler-1.6.3.tar.gz",
"has_sig": false,
"md5_digest": "1493e93079085ec839458e65204753db",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 53001,
"upload_time": "2023-01-06T02:16:20",
"upload_time_iso_8601": "2023-01-06T02:16:20.779491Z",
"url": "https://files.pythonhosted.org/packages/76/e0/5c6f8e4126ba3d0cd7f32c15142ebb78052b63481803b69436ca7c0ca7d8/trakt_scrobbler-1.6.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-06 02:16:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "iamkroot",
"github_project": "trakt-scrobbler",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "trakt-scrobbler"
}
JSON
