Home

Awesome

TraktForVLC Travis Build Status AppVeyor Build status

TraktForVLC allows scrobbling VLC content to trakt.tv.

TraktForVLC 2.x works by using together a lua VLC module and a Python helper script in order to find information on the media you are watching. Contrary to previous versions of TraktForVLC, the VLC module allows for a direct binding in your media activity (play, pause, stop) and thus to take immediate actions on your trakt.tv account.

Table of Contents

Information

Credits

This version of TraktForVLC has been rewritten from scratch.

All licensing and used code is mentionned directly in the code source, except for the external libraries and resources information provided below.

License

Copyright (C) 2017-2018 Raphaël Beamonte <raphael.beamonte@gmail.com>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

External libraries and resources

The vlc-logo-1s.mp4 file in this repository, also distributed in the binary files for Windows, contains a VLC logo that is not owned by this project. This logo is owned by its authors. VideoLAN can be reached on their website.

TraktForVLC uses external libraries and APIs for the media resolution:

TraktForVLC is not endorsed or certified by any of these external libraries and resources owners.

Installation

Finding the installers

Installers are provided in the GitHub release section. The latest release is available here; however, we highly recommend using a stable release if you are not sure of what you are doing.

Once you have found the installer that corresponds to your operating system and downloaded it, simply running it will allow you to install TraktForVLC with the default parameters.

Installation per OS

On Windows, you can right-click and run the file with the administrator privileges to start the install process. The administrator privileges are required as, on Windows, the Python helper is installed as a Windows service.

On Linux and MacOS, make the file executable (using chmod +x file) and then run it in the command line (./TraktForVLC_version_os).

Initial configuration

At the end of the first installation, the initial configuration will automatically be started by the installer. This process aims at authorizing TraktForVLC to access your trakt.tv account.

Depending on your OS, the process is presented a bit differently:

The message shown should look like the following:

TraktForVLC is not setup with Trakt.tv yet!
--
PLEASE GO TO https://trakt.tv/activate
AND ENTER THE FOLLOWING CODE:
9EC4F248

The instructions are to go to a URL and enter a given code. Please do while keeping the process (VLC window on Windows) active, and wait after entering the code and validating the authorization that the process stops by itself. If you stops the process before then, you will need to restart the initial configuration manually.

To restart the initial configuration process manually, the following command might be used: ./TraktForVLC_version_os init_trakt_auth

Configuration file

The configuration file for TraktForVLC is a JSON file named trakt_config.json.

Location

The trakt_config.json file is located in your VLC configuration directory. Depending on your OS, the VLC configuration directory will be located at the following places:

Sections

Issues

Please use the GitHub integrated issue tracker for every problem you can encounter. Please DO NOT use my email for issues or walkthrough.

When submitting an issue, please submit a VLC logfile showing the error. You can start VLC in debug mode (--vv option) to obtain more thorough logs.

Please be careful to remove any personnal information that might still be in the logfile (password, identification token, ...) before putting your file online.