mirror of
https://github.com/vinefeeder/TwinVine.git
synced 2026-07-15 18:10:04 +02:00
120 lines
4.8 KiB
Markdown
120 lines
4.8 KiB
Markdown
**TwinVine**
|
|
|
|
|
|
|
|
|
|
|
|
TwinVine is the home of TWO packages [Vinefeeder](https://github.com/vinefeeder/TwinVine/blob/main/packages/vinefeeder/src/vinefeeder/README.md)
|
|
and [Envied](https://github.com/vinefeeder/TwinVine/blob/main/packages/envied/README.md)
|
|
|
|
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.
|
|
```
|
|
**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:
|
|
|
|
```shell
|
|
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 8 services for which search, browse and list-select are available
|
|
|
|
ALL4 BBC ITVX MY5 STV TPTV TVNZ U
|
|
|
|
Envied has
|
|
|
|
ALL4 AUBC CBS DSCP iP MAX MY5 NF PCOK 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|