139 lines
3.7 KiB
Markdown
139 lines
3.7 KiB
Markdown
# Run Libation on Ubuntu
|
|
This walkthrough should get you up and running with Libation on your Ubuntu machine.
|
|
|
|
Some limitations of the linux release are:
|
|
- Cannot customize how illegial filename characters are replaced.
|
|
- The Auto-update function is unavailable
|
|
- The "Hangover" app for debugging is not yet available.
|
|
|
|
## Dependencies
|
|
### Dotnet Runtime
|
|
You must install the dotnet 6.0 runtime on your machine.
|
|
|
|
First, add the Microsoft package signing key to your list of trusted keys and add the package repository.
|
|
|
|
<details>
|
|
<summary>Ubuntu 22.04</summary>
|
|
|
|
```console
|
|
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
|
sudo dpkg -i packages-microsoft-prod.deb
|
|
rm packages-microsoft-prod.deb
|
|
```
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Ubuntu 21.10</summary>
|
|
|
|
```console
|
|
wget https://packages.microsoft.com/config/ubuntu/21.10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
|
sudo dpkg -i packages-microsoft-prod.deb
|
|
rm packages-microsoft-prod.deb
|
|
```
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Ubuntu 20.04</summary>
|
|
|
|
```console
|
|
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
|
sudo dpkg -i packages-microsoft-prod.deb
|
|
rm packages-microsoft-prod.deb
|
|
```
|
|
</details>
|
|
|
|
For other distributions, see [Microsoft's instructions for installing .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux).
|
|
|
|
Then install the dotnet 6.0 runtime
|
|
|
|
```console
|
|
sudo apt-get update; \
|
|
sudo apt-get install -y apt-transport-https && \
|
|
sudo apt-get update && \
|
|
sudo apt-get install -y dotnet-runtime-6.0
|
|
```
|
|
### FFMpeg (Optional)
|
|
If you want to convert your audiobooks to mp3, install FFMpeg using the following command:
|
|
|
|
```console
|
|
sudo apt-get install -y ffmpeg
|
|
```
|
|
|
|
## Install Libation
|
|
|
|
Download the most recent linux-64 binaries zip file and save it as `libation-linux-bin.zip`. Save the 'install-libation.sh' bash script to a file. From the terminal make the script file executable:
|
|
|
|
<details>
|
|
<summary>install-libation.sh</summary>
|
|
|
|
```BASH
|
|
#!/bin/bash
|
|
|
|
|
|
FILE=$1
|
|
|
|
if [ -z "$FILE" ]
|
|
then echo "This script must be called with a the Libation Linux bin zip file as an argument."
|
|
exit
|
|
fi
|
|
|
|
if [ "$EUID" -ne 0 ]
|
|
then echo "Please run as root"
|
|
exit
|
|
fi
|
|
|
|
if [ ! -f "$FILE" ]
|
|
then echo "The file \"$FILE\" does not exist."
|
|
exit
|
|
fi
|
|
|
|
echo "Extracting $FILE"
|
|
|
|
FOLDER="$(dirname "$FILE")/libation_src"
|
|
echo "$FOLDER"
|
|
|
|
sudo -u $SUDO_USER unzip -q -o ${FILE} -d ${FOLDER}
|
|
|
|
if [ $? -ne 0 ]
|
|
then echo "Error unzipping ${FILE}"
|
|
exit
|
|
fi
|
|
|
|
|
|
sudo -u $SUDO_USER chmod +700 ${FOLDER}/Libation
|
|
sudo -u $SUDO_USER chmod +700 ${FOLDER}/LibationCli
|
|
|
|
#Remove previous installation program files and sym link
|
|
rm /usr/bin/Libation
|
|
rm /usr/bin/LibationCli
|
|
rm /usr/bin/libationcli
|
|
rm /usr/lib/libation -r
|
|
|
|
#Copy install files, icon and desktop file
|
|
cp ${FOLDER}/glass-with-glow_256.svg /usr/share/icons/hicolor/scalable/apps/libation.svg
|
|
cp ${FOLDER}/Libation.desktop /usr/share/applications/Libation.desktop
|
|
mv ${FOLDER}/ /usr/lib/libation
|
|
|
|
chmod +666 /usr/share/icons/hicolor/scalable/apps/libation.svg
|
|
gtk-update-icon-cache -f /usr/share/icons/hicolor/
|
|
ln -s /usr/lib/libation/Libation /usr/bin/Libation
|
|
ln -s /usr/lib/libation/LibationCli /usr/bin/LibationCli
|
|
ln -s /usr/lib/libation/LibationCli /usr/bin/libationcli
|
|
|
|
echo "Done!"
|
|
|
|
```
|
|
</details>
|
|
|
|
```console
|
|
chmod +700 install-libation.sh
|
|
```
|
|
Then run the script with the libation binaries zipfile as an argument.
|
|
```console
|
|
sudo ./install-libation.sh libation-linux-bin.zip
|
|
```
|
|
|
|
You should now see Libation among your applications.
|
|
|
|
Report bugs to https://github.com/rmcrackan/Libation/issues
|