Skip to content

Latest commit

 

History

History
59 lines (56 loc) · 1.88 KB

readme.md

File metadata and controls

59 lines (56 loc) · 1.88 KB

Cinema

This is a command line tool used to download movies and series from the Cinema-API. It is bundled and distributed using executable files thus easily used by anyone who can operate the terminal without any knowledge of python programming.

Setup

  1. Clone the repo
git clone <url>
  1. Create a virtual environment in the base directory
python3 -m venv env
  1. Activate the virtual environment
env/scripts/activate # for windows
source env/bin/activate # for unix
  1. Install dependencies
python3 -m pip install -r requirements.txt

Authentication

All requests made from the cli-tool to the server require token authentication and if the user doesn't have an account or has never been authenticated, they will be required to authenticate themselves in order to access the functionalities auth_require

Operations

Latest

cinema latest

This command returns a list of the latest 10 titles from the api service.

Search

cinema search <query>

This returns a list of titles with the required query in their name. latest

Details

cinema details -m <machine_name>

Using the machine_name of a title, this command returns details about the movie ( using the -m flag ) or serie ( using the -sflag ) the user is interested in. details

Download

cinema download -m <machine_name>

Still using the machine_name of a title, this command downloads the movie or serie episode that the user is interested in. download

Help

For general help about the commands of the tool;

cinema --help

All other commands can have the --help or -h flag to them in order to get details on how to use them e.g

cinema download --help