Skip to content
Snippets Groups Projects

Step-by-Step Installation Instructions for Ubuntu

Open Falk Rehse requested to merge falk.rehse/syng:step-by-step-ubuntu into main
1 file
+ 64
0
Compare changes
  • Side-by-side
  • Inline
+ 64
0
# Step-by-Step Installation (Ubuntu)
## Install Ubuntu
You can download it from [ubuntu.com](https://ubuntu.com/download/desktop).
## Install Dependencies
Open a terminal in the folder you want to install Syng in: right click in Nautilus (the file manager) and select *Open in Terminal*.
__Python 3__ should already be installed on your system.
You also need __Git__, [pipx](https://github.com/pypa/pipx) (for installing Poetry), [mpv](https://mpv.io/) (for playing audio and videos) and [yt-dlp](https://github.com/yt-dlp/yt-dlp) (for downloading videos from YouTube) and __python3-tk__ to use the configuration GUI.
Install dependencies:
```
sudo add-apt-repository universe
sudo apt update
sudo apt install git pipx mpv yt-dlp python3-tk
```
[Poetry](https://python-poetry.org/) is recommended for managing the installation.
Install Poetry:
```
pipx install poetry
pipx ensurepath
```
Then close an reopen the terminal.
## Clone Repository
Clone the repository:
```
git clone https://git.k-fortytwo.de/christofsteel/syng2.git
```
Then enter the newly downloaded directory:
```
cd syng2
```
## Install Syng
Now the Python dependencies need to be installed. Poetry is recommended for this step, to not interfere with other Python projects on the same machine.
Install Syng:
```
poetry install -E client
```
## Configure Syng
Syng comes with a graphical configuration utility.
```
poetry run syng-gui
```
## Start Syng
Start Syng:
```
poetry run syng-client
```
Loading