Package: trackma
TrackmaTrackma aims to be a lightweight and simple but feature-rich program for Unix based systems
for fetching, updating and using data from personal lists hosted in several media tracking websites.FeaturesManage local list and synchronize when necessary, useful when offlineManage multiple accounts on different media tracking sitesSupport for several media types (as supported by the site)Multiple user interfaces (Qt, GTK, curses, command-line)Detection of running media player, updates list if necessaryAbility to launch media player for a requested media in the list and update list if necessaryHighly scalable, easy to code new interfaces and support for other sitesSecure, uses HTTPS wherever possible.Currently supported websitesAnilist(Anime, Manga)Kitsu(Anime, Manga, Drama)MyAnimeList(Anime, Manga)Shikimori(Anime, Manga)VNDB(VNs)ScreenshotsQt interfaceGTK interfaceCurses interfaceCLIDependenciesThe only required dependency to run Trackma is:Python 3.7+python3-pip(to install throughpip)orpython3-poetry(to install throughpoetry)But only basic features will work (only CLI interface and no tracker). Everything else is optional.The following user interfaces are available and their requirements are as follows:UIDependenciesQtPyQt5 (python-pyqt5)GTK 3PyGI (python3-giandpython3-cairo)cursesUrwid (python3-urwid)CLINoneThe following media recognition trackers are available and their requirements are as follows:TrackerDescriptionDependenciesinotifyInstant, but only supported in Linux. Uses it whenever possible.inotifyorpyinotifyPollingSlow, but supported in every POSIX platform. Fallback.lsofPlexConnects to Plex server. Enabled manually.NoneKodiConnects to Kodi server. Enabled manually.NoneJellyfinConnects to Jellyfin server. Enabled manually.NoneMPRISConnects to running MPRIS capable media players.dbus-pythonWin32Recognition for Windows platforms.NoneAdditional optional dependencies:PIL (python3-pil) - for showing preview images in the Qt/GTK interfaces.InstallationTrackma has user-provided packages for several distributions.Arch Linux:https://aur.archlinux.org/packages/trackma,http://aur.archlinux.org/packages/trackma-gitFedora:https://copr.fedoraproject.org/coprs/dyskette/trackma/Gentoo Linux:http://gpo.zugaina.org/net-misc/trackmaNixOS:https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/trackma/default.nixVoid Linux:https://github.com/void-linux/void-packages/blob/master/srcpkgs/trackma/templateA user from the community also is providing a Docker image:Docker:https://hub.docker.com/r/frosty5689/trackma/Manual installationMake sure you've installed the proper dependencies (listed above)
according to the user interface you plan to use, and then run the
following command:$pip3installTrackmaYou can also install the git (probably unstable, but newer) version like this:$pip3install-Ugit+https://github.com/z411/trackma.gitOr download the source code and install:$gitclone--recursivehttps://github.com/z411/trackma.git
$cdtrackma
$poetrybuild
$pip3installdist/trackma-0.8.5-py3-none-any.whlExtras (User Interfaces)All user interfaces except for the default CLI mode require additional dependencies to function.
You may specify these as "extras" to be installed by the Python package manager.The following extras are available:ExtraDescriptiongtkThe GTK interface.qtThe GTK interface.cursesThe curses-based TUI.uiAll user interfaces.trackersAll tracker libraries.discord_rpcSet your watching activity in Discord.twitterAnnounce your watching activity on Twitter.If you want to install any of the extras be sure to specify them during installation:pip# With pip$pip3installTrackma[gtk,trackers,curses]$pip3installTrackma[ui,twitter,discord_rpc]Note that pip does not have a way to install all available extras,
so you'll have to provide them all manually if desired.Then you can run the program with the interface you like.$trackma
$trackma-curses
$trackma-gtk
$trackma-qtpoetryWhen using poetry on the cloned repository (see above),
you can install your desired extras as follows:$poetryinstall-Egtk-Etrackers-Ecurses
$poetryinstall-Eui-Etwitter-Ediscord_rpc
$poetryinstall--all-extrasThen you can run the interface you like in your virtual environment managed by poetry:$poetryruntrackma
$poetryruntrackma-curses
$poetryruntrackma-gtk
$poetryruntrackma-qtConfigurationA configuration file will be created in~/.config/trackma/config.json, make sure to fill in the directory
where you store your video files and other settings. Details about what each option does can be done here:https://github.com/z411/trackma/wiki/Configuration-FileAlternatively, the GTK and Qt interfaces provide a visual Settings panel.DevelopmentThe code is hosted as a git repository onGitHub.Clone the repo and create the virtual environment usingpoetry:$gitclone--recursivehttps://github.com/z411/trackma.git
$cdtrackma
$poetryinstall--all-extras
$poetryshellUse the above commands from thepoetrysection
for how to run your desired interface.If you encounter any problems or have anything to suggest, please don't
hesitate to submit an issue in the GitHubissue tracker.LicenseTrackma is licensed under the GPLv3 license, please seeLICENSEfor details.AuthorsTrackma was originally written by z411z411@omaera.org. For other contributors see AUTHORS file. GTK icon designed by shuuichi.