Skip to content

CLI for searching webshare and opening media content in various media players

License

Notifications You must be signed in to change notification settings

Seraphim-Solutions/bettercinema

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

We are looking for a logo and icon. If you are interested please contact us at business@seraphim-solutions.com

BetterCinema

GitHub release (latest by date) GitHub code size in bytes GitHub repo file count Code Climate maintainability Code Climate issues

What is this?

‘BetterCinema’ is a CLI tool for searching webshare.cz focused mainly on videos. Inspired by Stream Cinema Community.

With this tool, you can easily search the contents of webshare and open them in VLC (again video related).

better-cinema

Why use this and not stream cinema?

Well, stream cinema has a manual database with movies, so some things aren’t there immediately, but they can be on webshare.

Also, it feels quicker.

Installation

Download release for your operation system of choice here

Build instructions

git clone https://github.com/Seraphim-Solutions/bettercinema.git
cd bettercinema
python3 -m pip install -r requirements.txt
python3 app.py

Requirements

VLC

You’ll need the VLC media player installed. And it has to be in its default directory(Program Files/VideoLAN/VLC/). (for now)

I’m not using the VLC library because I find this more simple.

Libraries

All libraries will be in requirements.txt for now

  • later there will be a setup function.

Usage

Using ‘BetterCinema’ (or just BC in short) is quite simple.

The first time you open BC you’ll be asked for your webshare credentials.

After you login, username and your salted password hash will be stored in ‘data.db’, so you don’t have to log in every time you open BC.

Login preview

After you logged in, you will see few options:

  • Default Search
  • Advanced Search
  • Open Link
  • Trakt.tv
  • Settings

Search preview

Default Search is pre-configured with some parameters, except search query of course.

These parameters are:

  • limit of results = 25

  • category = video

  • sort = relevance (Webshare uses empty string for Relevace)

NOTE You will expand the search with the more command after your search

Advanced Search can search anything on webshare, all categories, all sortings, and custom search limit.

If you select Advanced Search these are inputs, the tool will ask you for:

  • name = search query

  • limit = number of returned results

  • category = you can select from 7 categories (video, audio, images, archives, docs, software, adult)

  • sort = you can select from 5 categories (largest, smallest, recent, relevance, rating)

Selecting any of these search options will bring a table with results.

Result table for advanced search

Name color is selected by upvotes(green) / downvotes(red), white color is for neutral votes 50/50

This part is quite self-explanatory, to select a specific movie just type the index number of it and it will instantly trigger VLC to open with that specific file.

For more options when browsing the result table, type help.

Have any questions? Use Discussion.

Do you have any idea for a feature? Use This template.

Do you want to report a bug? Use This template.