serctl 0.1.0

REPL to manage and rate series.

Series Control REPL

---

Description

A terminal-based REPL tool to manage and rate TV series of your own preference.

Table of Contents

• Showcase
• Features
• Installation
  • From PyPI
  • From source
• Usage
• OMDb API Key
• Contributing

Showcase

Features

• Add series and organize them by seasons and episodes
• Rate episodes individually or all at once (0 to 10, up to 2 decimal places)
• View a color-coded ratings table by episode and season
• Compare two series side by side
• Import IMDb ratings via the OMDb API
• Data is saved automatically in a local JSON file

Install

Requires Python 3.10+ and pipx.

From PyPI

pipx install serctl

From source

git clone https://github.com/tu-usuario/serctl.git
cd serctl
pipx install -e .

Usage

Run the program with:

serctl

Then use any of the available commands:

Command	Description
ns	Add a new serie
as	Add seasons to a serie
ams	Add more seasons to an existing serie
es	Eliminate a serie
prte	Rate a specific episode
ra	Rate all episodes from a serie
ss	See all series
ser	See episode ratings table
cs	Compare two series side by side
setkey	Save your OMDb API key
exit	Exit the program

Type help inside the program to see all commands, and - at any prompt to return to the command box.

Uninstall

pipx uninstall serctl

Dependencies

Package	Version
InquirerPy	>=0.3.4
platformdirs	>=4.0.0

OMDb API Key

The cs command supports IMDb ratings via the OMDb API. To use it, get a free key at omdbapi.com/apikey.aspx and save it with the setkey command (Free version should be enough for personal usage).

Contributing

See CONTRIBUTING.md for details.