Skip to content

Latest commit

 

History

History
94 lines (71 loc) · 1.9 KB

README.md

File metadata and controls

94 lines (71 loc) · 1.9 KB

SortHero

A powerful media file organizer that automatically renames and sorts your movies and TV shows using TMDB and TVDB data. This is still in beta but works really well, i will add some improvements

Features

  • Automatic media detection and parsing
  • Movie info from TMDB API
  • TV show info from TVDB API
  • Supports multiple file operations (move/copy/symlink)
  • Dry-run mode for safe testing
  • Debug mode for troubleshooting
  • Configurable source and destination directories
  • Supports common video formats (MP4, MKV, AVI, etc.)

Installation

go get github.com/yourusername/sorthero

Configuration

Create a config.json file:

{
    "tmdb_api_key": "your_tmdb_key_here",
    "tvdb_api_key": "your_tvdb_key_here"
}

Get your API keys from:

Usage

Basic usage:

sorthero -source "/path/to/media" -dest "/path/to/library"

Available options:

  -config string
        Path to config file (default "config.json")
  -debug
        Enable debug logging
  -dest string
        Destination directory (default ".")
  -dry-run
        Show what would be done without making changes
  -op string
        Operation: move, copy, or symlink (default "move")
  -source string
        Source directory (default ".")

Examples

Test run with debug info:

sorthero -source "/downloads" -dest "/media" -debug -dry-run

Copy files instead of moving:

sorthero -source "/downloads" -dest "/media" -op copy

Create symlinks:

sorthero -source "/downloads" -dest "/media" -op symlink

File Naming

Movies

Input: Movie.Name.2020.1080p.mkv Output: Movie Name (2020) [1080p].mkv

TV Shows

Input: Show.Name.S01E02.720p.mp4 Output: Show Name S01E02 [720p].mp4

License

MIT

Contributing

Pull requests welcome! Please read our contributing guidelines first.