Seiri

Seiri is a command line utility that connects to put.io and organizes your movie folders by genre using TMDB API.

Features

• Connects to your put.io account using OAuth token
• Retrieves all folders from your put.io account
• Searches each folder name in TMDB to find the movie's genre
• Downloads each folder to a genre-specific directory on your local machine
• Cleans up movie titles before searching to improve match accuracy
• Supports dry-run mode to preview organization without downloading
• Caches genre information to reduce API calls
• Saves configuration for easy repeated use

Requirements

• Python 3.6+
• put.io OAuth token
• TMDB API key

Installation

Option 1: Install from source

1. Clone this repository:

git clone https://github.com/yourusername/seiri.git
cd seiri

2. Install the package:

pip install -e .

This will make the seiri command available globally.

Option 2: Run directly

1. Clone this repository:

git clone https://github.com/yourusername/seiri.git
cd seiri

2. Install required dependencies:

pip install requests

3. Run the script:

python seiri.py

Setup

Before using Seiri, you need to set up your put.io OAuth token and TMDB API key:

1. Get a put.io OAuth token from your put.io account settings
2. Get a TMDB API key by registering for an account and requesting an API key

Run the setup command:

seiri --setup

or

python seiri.py --setup

This will prompt you for your put.io OAuth token, TMDB API key, and the destination directory where you want to organize your movies.

Usage

List all folders in your put.io account

seiri --list

Organize movies by genre

seiri

Dry run (preview without downloading)

seiri --dry-run

Override saved configuration

seiri --token YOUR_TOKEN --tmdb-key YOUR_KEY --dest /path/to/movies

How it works

1. Seiri connects to your put.io account and retrieves all folders
2. For each folder, it cleans up the name by removing common filename patterns (resolution, year, codec, etc.)
3. It searches the cleaned name in TMDB to find the corresponding movie
4. It extracts the primary genre (first listed genre) for the movie
5. It creates a genre folder in your destination directory if it doesn't exist
6. It downloads the folder and all its contents to the appropriate genre folder

License

MIT