Skip to content

Repository files navigation

media-launcher

Media Launcher automatically matches TV episodes with their corresponding external audio and subtitle tracks and generates launch scripts for playback in your preferred video player.

Cross-platform, scriptable, and built for MPV, VLC, POT players

Installation

Windows

Download .exe file from releases

Archlinux

yay -S media-launcher

or

paru -S media-launcher

MacOS

brew tap akoidan/media-launcher https://github.com/akoidan/media-launcher
brew trust akoidan/media-launcher
brew install media-launcher

Other Linux distro

Download .elf file from releases

How to use

  • Download executable application file from releases
  • Run it either by opening it, either passing folder with TV series path as first argument
  • THe app will scan TV season folder and matche each episode with its external audio and subtitle tracks using smart \d\d pattern.
  • It will generater one launcher per episode (01, 02, …):
    • Linux: 01.bash, 02.bash, …
    • Windows: 01.cmd, 02.cmd, …
    • Mac: 01.command, 02.command, …
  • Open the corresponding launcher by double clicking on it and the player should open automatically.

Playback

  • Uses mpv, VLC, or PotPlayer (Windows only; must be available in $PATH or its default install location)
  • If multiple are found, priority is mpv > VLC > PotPlayer
  • If only one is found, it is used automatically
  • All matching audio and subtitle tracks are attached

Development

See CONTRIBUTING.md

About

Media Launcher automatically matches TV episodes with their corresponding external audio and subtitle tracks and generates launch scripts for playback in your preferred video player.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages