Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tremby/jellyfin-find-duplicates

Find duplicate TV show episodes in a Jellyfin library
https://github.com/tremby/jellyfin-find-duplicates

Last synced: about 1 month ago
JSON representation

Find duplicate TV show episodes in a Jellyfin library

Awesome Lists containing this project

README

        

# jellyfin-find-duplicates

Find duplicate TV show episodes in a Jellyfin library.

## Usage

jellyfin-find-duplicates [-h] [--help]

Information is output about any duplicate episodes found.
If the program exits with no output and a success status,
no duplicates were found.

### Options

- `-h`, `--help`: Show help text

### Example output

```
Series "The Itchy and Scratchy Show" has duplicates:
The Itchy and Scratchy Show S01E01
- 1990-01-28T19:42:33-05:00: \\disk\shows\The Itchy and Scratchy Show\Season 01\The.Itchy.And.Scratchy.Show.S01E01.1080p.WEB.H264-MUNTZ.mkv
- 1990-01-28T20:01:42-05:00: \\disk\shows\The Itchy and Scratchy Show\Season 01\the.itchy.and.scratchy.show.s01e01.proper.1080p.web-dl.h264-elbarto.mkv
The Itchy and Scratchy Show S01E04
- 1990-10-11T19:50:01-04:00: \\disk\shows\The Itchy and Scratchy Show\Season 01\The.Itchy.And.Scratchy.Show.S01E04.720p.HDTV.H.264.mPRiNCE.mkv
- 1990-10-11T20:09:22-04:00: \\disk\shows\The Itchy and Scratchy Show\Season 01\the.itchy.and.scratchy.show.s01e04.1080p.web-dl.h264-elbarto.mkv
Series "Single Female Lawyer" has duplicates:
Single Female Lawyer S01E01
- 1999-11-07T20:00:05-05:00: \\disk\shows\Single Female Lawyer\Season 01\Single.Female.Lawyer.S01E01.480p.NTSC.h264-LRRR.mkv
- 2000-01-22T14:17:06-05:00: \\disk\shows\Single Female Lawyer\Single.Female.Lawyer.S01.480p.NTSC.h264-LRRR\Single.Female.Lawyer.S01E01.480p.NTSC.h264-LRRR.mkv
Single Female Lawyer S01E02
- 1999-11-14T20:04:30-05:00: \\disk\shows\Single Female Lawyer\Season 01\Single.Female.Lawyer.S01E02.480p.NTSC.h264-LRRR.mkv
- 2000-01-22T14:17:06-05:00: \\disk\shows\Single Female Lawyer\Single.Female.Lawyer.S01.480p.NTSC.h264-LRRR\Single.Female.Lawyer.S01E02.480p.NTSC.h264-LRRR.mkv
Single Female Lawyer S01E03
- 1999-11-21T19:48:50-05:00: \\disk\shows\Single Female Lawyer\Season 01\Single.Female.Lawyer.S01E03.480p.NTSC.h264-LRRR.mkv
- 2000-01-22T14:17:06-05:00: \\disk\shows\Single Female Lawyer\Single.Female.Lawyer.S01.480p.NTSC.h264-LRRR\Single.Female.Lawyer.S01E03.480p.NTSC.h264-LRRR.mkv
```

## Configuration

The file `$XDG_CONFIG_HOME/jellyfin-find-duplicates.conf`
(which is usually `~/.config/jellyfin-find-duplicates.conf`)
is sourced as a bash script if it exists.

An example is distributed as `jellyfin-find-duplicates.conf.example`
it can be copied into place with

cp jellyfin-find-duplicates.conf.example $XDG_CONFIG_HOME/jellyfin-find-duplicates.conf

and then edited.

The following variables are then expected to exist:

- `JELLYFIN_HOST`
The Jellyfin URL scheme and hostname for the server,
with no trailing slash.
Example: `https://jellyfin.local`
- `JELLYFIN_TOKEN`:
The Jellyfin API token.
One can be made via the Jellyfin dashboard, at "Advanced" → "API Keys".
Example: `abc123abc123`
- `JELLYFIN_USER`:
The name of the Jellyfin user to use as context.
Example: `bob`
- `JELLYFIN_SHOWS_LIB_NAME`:
The name of the TV shows library in Jellyfin.
Example: `Shows`

## Dependencies

- `curl`, which you probably have. If not, it is in every package manager.
Run `apt install curl` or equivalent.
- `jq`, the JSON toolkit, which you may not have.
Run `apt install jq` or equivalent.

## Compatibility

So far this is only tested on Linux.
It may work on other platforms.

## Contributing

Patches welcome.

Ideas:

- Improve speed
- Improve output
- Also notice any missing episodes