TwinVine

TwinVine is the home of TWO packages Vinefeeder and Envied

TwinVine is the easy way to handle your download tasks.

• When you have an exact program url - just use envied as a command line call.
• When you only have the program name - just start with a search in vinefeeder.
• When you dont know what you want; use the browse function.
• Browse media categories like Film, Drama or Sport, for a selected service.
• Batch Mode: select multiple downloads from various services and download all together.

usage

uv run envied dl (options) (service) (program url)

uv run vinefeeder  - to open the interactive GUI for search, browse, etc.

To go to the command line use of 'envied' after using the GUI: close the GUI directly, or ctrl+c in terminal.

Installation

Uv is the package manager and loads both VineFeeder and Envied together. Envied runs independenly or may be called by Vinefeeder.

If you do not alrealy have uv as a python package install it first, using pip -

pip install uv

or

python3 -m pip install uv

Then install TwinVine; the following installs the latest version directly from the GitHub repository:

git clone https://github.com/vinefeeder/TwinVine.git
cd TwinVine
uv clean
uv lock
uv sync
uv run vinefeeder --help or
uv run envied --help

Configuration

Run this line inside the VineFeeder folder:

cp packages/envied/src/envied/envied-working-example.yaml packages/envied/src/envied/envied.yaml 

This ensures you have your own working copy of envied.yaml. It may be edited and will not be over-written during any updates.

That's it; uv run vinefeeder to get started!

Linux

Linux systems are known to screen freeze after envied has finished a download. The top level vinefeeder config file at TwinVine/packages/vinefeeder/src/vinefeeder/config.yaml should have TERMINAL_RESET: True set.

Services

Vinefeeder currently has 10 services for which search, browse and list-select are available

ALL4 BBC ITVX MY5 PLEX RTE STV TPTV TVNZ U

Envied has

ALL4 AUBC CBS CWTV DSCP iP MAX MY5 NF PCOK PLEX RTE ROKU SPOT TPTV TVNZ YTBE ARD CBC CTV DSNP ITV MTSP NBLA NRK PLUTO RTE STV TUBI UKTV ZDF These services have web-origins and not all have been tested by me.

**Other README's"" TwinVine/packages/vinefeeder/src/vinefeeder/README.md
for details for confuring Envied download options on a service by service basis. TwinVine/packages/envied/README.md links to wiki (unshackle - envied's parent)

Newbies

If you are totally new to downloading there are software items that all downloaders call upon to carry out their functions. TwinVine is no different.

You need to have some binaries installed and on your system's Path. For your security find them from source.

They need to be on your system's Path, For linux installng to /home/user/.local/bin/ is ideal For Windows it is less clear cut. If you know how to create a folder and then add the folder to the Windows systems Environment Path, then do that and place all your binaries in the new folder. (I have cheated in the past and used C:\Windows\System32)

The binary list:

• Python 3.11 or later installed with Linux: or Windows install from the Windows Store
• ffmpeg (https://github.com/FFmpeg/FFmpeg) https://www.videohelp.com/software/ffmpeg or Linux distro
• N-m3u8DL-RE (https://github.com/nilaoda/N_m3u8DL-RE/releases)
• mp4decrypt (https://github.com/axiomatic-systems/Bento4)
• MKVMerge from MKVToolNix https://mkvtoolnix.download/downloads.html https://www.videohelp.com/software/MKVToolNix
• Shaka-packager https://github.com/shaka-project/shaka-packager/releases rename the binary to shaka-packager

Images