Series-Tracker

A program to keep track of all your series you are currently watching, you plan to watch in the future and all those you already finished. This program helps you to never watch an episode again because you forgot if you already saw it, or reminds you of the series you started, but never finished as you forgot that there was a new season. All data is provided by TheTvdb.com, a database of TV series.

Usage

Requirements

• You need Java 11 or higher for this program.
• The .jar-File for your platform of the SeriesTracker.
• And furthermore an account and a v3 API-Key from TheTvdb.com.

Start

Start the .jar via Commandline, via double-click or via right-click "Open with...".

cd path/to/jar
java -jar SeriesTracker-release-X.jar

If you want to clone or download and extract the repository yourself you can start the program like this:

• Open the CMD/Terminal in the folder where the files are located.
  • On Linux or Windows with gradle installed type: gradle run.
  • On Linux without gradle installed type: ./gradlew run.
  • On Windows without gradle installed type: gradlew.bat run.

How to use the tracker

How to get an API Key

• First create an account on theTVDB.com.
• Generate a new v3 API Key here.
• Afterwards copy the Username (in the @ field) and Unique User Key from here and the API Key from here.
• On first start of the program provide that data to the three text fields.

Basic operations

• You can open the menu with a click on the hamburger icon at the top left
• To add a series open the menu and click on "Add a new series"
  • Type the name of the series in the text field and press enter/click on "Add series"
  • If there are multiple matches you may need to select the desired series in the following screen
• Search a series in your local series by opening the menu and clicking on "Search for a series"
• Updates your local series data by clicking on "Update".
• Right-click a series in the main menu and click on "Information" to see some information about that series.

Customization

You can use custom backgrounds in the main menu. Just navigate to your Home folder, open the SERIESTRACKER folder and place your png, jpg, or jpeg in /Backgrounds/. The home folder location depends on your operating system:

Windows: C:\\Users\<CurrentUserName>
Linux: /home/<CurrentUserName>
Mac: /Users/<CurrentUserName>

Legal Notice

TV information and images are provided by TheTvdb.com, but I am not endorsed or certified by TheTvdb.com or its affiliates.

Credits

The default background image is from Tim Mossholder on Pexels.

The 'No Image Available' icon is from Homie the gorilla.