evansky

command module
v0.4.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 12, 2026 License: MIT Imports: 1 Imported by: 0

README

evansky: Media Renamer

CLI tool used to organize/rename media files, in order to be correctly detected by media server (e.g. jellyfin, emby, kodi).

It does so by parsing each directory/file name using middelink's parser and match result against TheMovieDatabase API.

evansky does cache scan results in order to guarantee that applied directory/file renaming is the same as the one from the initial dry-run preview.

evansky follow naming convention as per the Jellyfin documentation.

Requirement

Run

$ export TMDB_API_KEY="your api key"
$ evansky rename /path/to/dir
INF [dry-run] renamed source="test1.1997.1080p.BluRay.x264.anoXmous" destination="test1 (1997)"
INF [dry-run] renamed source="test2 1977 1080p Bluray x265 10Bit AAC 2.0 - GetSchwifty.mkv" destination="test2 (1978)"
INF [dry-run] renamed source="test3 (2017) [1080p] [YTS.AM]" destination="test3 (2017)"
INF [dry-run] renamed source="test4 (1980) [1080p] [BluRay] [5.1] [YTS.MX]" destination="test4 (1980)"
INF [dry-run] renamed source="test5 (1982) [1080p]" destination="test5 (1982)"
INF [dry-run] renamed source="test6.1935.1080p.HDTV.x264-REGRET[rarbg]" destination="test6 (1935)"
INF [dry-run] renamed source="test7 (1973) [1080p] [BluRay] [YTS.MX]" destination="test7 (1973)"
INF [dry-run] renamed source="test8 (1987) [BluRay] [1080p] [YTS.AM]" destination="test8 (1987)"
INF [dry-run] renamed source="test9 (1984) [BluRay] [1080p] [YTS.AM]" destination="test9 (1984)"
INF [dry-run] renamed source="test10.1984.1080p.BluRay.H264.AAC-RARBG" destination="test10 (1984)"
INF [dry-run] renamed source="test11 (1958) [BluRay] [1080p] [YTS.LT]" destination="test11 (1958)"
INF [dry-run] renamed source="test12 (2001) [1080p]" destination="test12 (2001)"
INF [dry-run] renamed source="test13 (2001) - 1080p" destination="test13 (2001)"
INF [dry-run] renamed source="test14.2012.720p.BluRay.x264-LOST [PublicHD]" destination="test14 (2012)"
INF [dry-run] renamed source="test15 (2001) 1080p BluRay.x264 SUJAIDR" destination="test15 (2001)"
INF [dry-run] renamed source="test16.2011.LIMITED.1080p.BluRay.x264.anoXmous" destination="test16 (2011)"
INF [dry-run] renamed source="test17 (1996) 1080p BluRay x265 HEVC SUJAIDR" destination="test17 (1996)"
INF [dry-run] renamed source="test18.1999.director name" destination="test18 (1999)"
INF [dry-run] renamed source="test19.EXTENDED.KOREAN.1080p.BluRay.H264.AAC-VXT" destination="test19 (2016)"
INF [dry-run] renamed source="test20.1984.1080p.BluRay.x264.anoXmous" destination="test20 (1984)"
INF [dry-run] renamed source="test21.1975.Criterion.1080p.BluRay.HEVC.AAC-SARTRE" destination="test21 (1975)"
INF [dry-run] renamed source="test22 (director name, 1970).ru-eng.avi" destination="test22 (1970)"
INF [dry-run] renamed source="test23.2020.repack.1080p.web.hevc.x265.rmteam.mkv" destination="test23 (2020)"
INF [dry-run] renamed 23/23 file(s)
$ # Run the same command with --write to apply changes

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
Package cmd implements the command line interface of evansky.
Package cmd implements the command line interface of evansky.
log
Package log provides common logging configuration for cobra commands.
Package log provides common logging configuration for cobra commands.
rename
Package rename implements the "rename" command, which renames and organizes directory content based on metadata providers and user-defined options.
Package rename implements the "rename" command, which renames and organizes directory content based on metadata providers and user-defined options.
pkg
parser
Package parser provides functions to parse torrent file names and extract relevant information such as title, year, season, episode, etc.
Package parser provides functions to parse torrent file names and extract relevant information such as title, year, season, episode, etc.
provider
Package provider provides interfaces and types for metadata providers that fetch information about movies and TV shows.
Package provider provides interfaces and types for metadata providers that fetch information about movies and TV shows.
renamer
Package renamer provides functionality for renaming media files based on metadata from external providers.
Package renamer provides functionality for renaming media files based on metadata from external providers.
source
Package source provides interfaces and types for media file scanning and processing.
Package source provides interfaces and types for media file scanning and processing.
source/language
Package language provides language detection capabilities for media files and directories.
Package language provides language detection capabilities for media files and directories.
tmdb
Package tmdb provides a client for The Movie Database (TMDB) API.
Package tmdb provides a client for The Movie Database (TMDB) API.
tmdb/httpcache
Copied from https://github.com/gohugoio/httpcache/blob/d62773ca3b8d72fe53e88e00d3831ccaca8b1ffc/httpcache.go Changed:
Copied from https://github.com/gohugoio/httpcache/blob/d62773ca3b8d72fe53e88e00d3831ccaca8b1ffc/httpcache.go Changed:

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL