Skip to main content

Remember watched tv episodes, resume from where you left off

Project description


PyPI version Latest Github release Python Build Status License

folderplay is a small tool that helps you remember watched tv episodes :sparkles:

Its goal is to resume playback from the episode you left off with a single button press. It doesn't use any integrated players so you can still use your favourite one.

Advaced view


🚩 Table of Contents

🎨 Features

  • Continue playback with a single button press
  • Play with your favoure video player
  • Filter and search your playlist
  • Displays general media info
  • Supports basic command line interface
  • Minimalistic GUI
  • Supports multiple color styles
  • Supports multiple icon sets
  • No installation required - the whole program is a single executable file
  • Cross platform - supports all three major platforms (Windows, MacOS, Linux) thanks to python and pyqt

⚙️ How it works

folderplay scans for known extensions in the current working directory and all subdirectories. It marks the files as watched or unwatched by checking for a specific prefix in the filename. It also searches for a list of predefined players for current operating systems. If the application can't find one, it will throw a warning and will ask you to select the player. When you hit the play button folderplay spawns a new process with the selected player, freezes the UI and waits for the process to exit. When the playes process exits folderplay will rename the media file by prepending a prefix to its filename to mark it as watched.

💾 Installation

Prebuilt binaries for macOS and Windows can be downloaded from the GitHub releases page.

:warning: Note that the binaries were not thoroughly tested across different platforms and might not work correctly.

The recommended installation method is using pip:

pip install folderplay

If you're on Linux, you have to additionally install libmediainfo-dev. For Debian-based systems it's as simple as running

sudo apt-get install libmediainfo-dev

After installation, the fplay command will be available. Check the command line section for supported commands.

📙 Usage

Simply drop the executable into the directory where your media resides and run it. The application will scan all directories and subdirectories for known extensions.

By default the app runs in basic view mode. You can toggle to the more advanced view by pressing the gear button. From there you can select the video player to use (folderplay will try to search for existing video players and will warn you on start up if it didn't find one).

You can filter your media list using the search form. The list also has supports context menu with some handy commands.

🔨 Building

Clone master branch or checkout a specific tag

git clone

Create new virtual environment inside of the folderplay directory

python3 -m venv venv

source venv/bin/activate # Linux / MacOs

venv\Scripts\activate # Windows

Install dependencies

pip install -r requirements.txt

Now either run the application

python -m folderplay

Or create an executable (will be save inside of the dist directory)

python -m PyInstaller folderplay.spec

🖥️ Command line interface

Currently fplay supports these commands

Usage: fplay [OPTIONS] <directory>

  --version            Show the version and exit.
  -p, --player <path>  Host player binary
  -s, --style <name>   Color style: dark, light, fusion, native
  -i, --icons <name>   Icon set: material, feather
  --help               Show this message and exit.

:octocat: Credits

Work from these open source projects is used by this application

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

folderplay-0.4.3.tar.gz (131.2 kB view hashes)

Uploaded source

Built Distribution

folderplay-0.4.3-py3-none-any.whl (146.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page