Isolated installation via uv
This method uses uv to install and run the program.
This installation method is preferred if you want to install the program on a specific folder of your choice (e.g., Documents folder) so that all of the installation and opening of the program only happens there.
If you also write scripts to download live streams, this is also the recommended installation.
Requirements
- Windows or Linux
- Python
v3.10
or greater - FFmpeg
- uv
- Git (optional)
Steps
- Install Python 3.10.0 or above. For Windows users, ensure
Add Python x.x to PATH
is checked. - Install FFmpeg. For Windows users, follow this guide for proper installation.
- Open your command-line.
-
Install uv through
pip
command or via Standalone installer.pip install uv
-
Choose a location to store the program's data or source code, and create a folder there (e.g., create a folder named
tk3u8
inside your Documents directory). -
Initialize the created folder with the following command.
uv init --app
This will create some stuff needed to isolate the installation of dependencies to this folder.
-
Install the latest published stable release of tk3u8 by adding it as a dependency.
uv add tk3u8
Alternatively, if you want to get the latest published pre-release version, run this command instead.
uv add --prerelease allow tk3u8
Or if you want to get the most recent update without having to wait for official pre-release, choose this one instead.
uv add git+https://github.com/Scoofszlo/tk3u8
Warning
Installing pre-release versions is discouraged as I don't guaranteed them to be stable enough. Although there are testing done for these versions, it is still better if you install the latest stable instead.
-
Run the program.
When stable release is installed properly, the output should look like this:uv run tk3u8 -v
tk3u8 v0.4.0
Updating tk3u8
To update tk3u8, run the following command.
uv lock -P tk3u8