Installation

Table of Contents

1. Via APT Repository (recommended)
2. Via .deb Package
3. Via pip
4. System-wide Install
5. Build .deb Package
6. Uninstall
7. Nemo File Manager Integration
8. Verification

---

Via APT Repository (recommended)

Add the SimplyConvertFile APT repository to get automatic updates via apt upgrade:

# Import the signing key
curl -fsSL https://thigschuch.github.io/SimplyConvertFile/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/simplyconvertfile.gpg

# Add the repository
echo "deb [signed-by=/usr/share/keyrings/simplyconvertfile.gpg] https://thigschuch.github.io/SimplyConvertFile/ stable main" | sudo tee /etc/apt/sources.list.d/simplyconvertfile.list

# Install
sudo apt update && sudo apt install simplyconvertfile

To update later:

sudo apt update && sudo apt upgrade

Via .deb Package

Download and install the latest .deb release directly from the terminal:

# Download the latest release
wget -O /tmp/simplyconvertfile.deb \
  "$(curl -s https://api.github.com/repos/ThigSchuch/SimplyConvertFile/releases/latest \
  | grep -o '"browser_download_url": "[^"]*\.deb"' \
  | cut -d'"' -f4)"

# Install it
sudo dpkg -i /tmp/simplyconvertfile.deb
sudo apt-get install -f

Or download manually from the Releases page and install:

sudo dpkg -i simplyconvertfile_*.deb
sudo apt-get install -f  # install dependencies if needed

Via pip

git clone https://github.com/ThigSchuch/SimplyConvertFile.git
cd SimplyConvertFile
pip install .

Then optionally add desktop integration:

cp packaging/simplyconvertfile.desktop ~/.local/share/applications/
cp src/simplyconvertfile/resources/icon.png ~/.local/share/icons/hicolor/48x48/apps/simplyconvertfile.png
gtk-update-icon-cache -f -t ~/.local/share/icons/hicolor/
update-desktop-database ~/.local/share/applications/

System-wide Install

sudo make install

Build .deb Package

make deb

Uninstall

sudo apt remove simplyconvertfile
# or
sudo make uninstall
# or
pip uninstall simplyconvertfile
# Also delete config files
rm -rf ~/.config/simplyconvertfile

Nemo File Manager Integration

If you use the Cinnamon desktop, you can integrate SimplyConvertFile into Nemo’s context menu.

Cinnamon Spices (recommended)

1. Search in the Menu for “Actions” and open it.
2. Go to the “Download” tab and search for “Simply”.
3. Click to install “SimplyConvertFile” to your actions.
4. Back to the “Installed” tab, find “SimplyConvertFile” and click “Enable”.

You can get more information on Cinnamon Spices here.

If installed from source / pip (the packaging/ directory is available):

cp packaging/simplyconvertfile.nemo_action ~/.local/share/nemo/actions/

If installed via APT or .deb:

mkdir -p ~/.local/share/nemo/actions
curl -fsSL https://raw.githubusercontent.com/ThigSchuch/SimplyConvertFile/main/packaging/simplyconvertfile.nemo_action -o ~/.local/share/nemo/actions/simplyconvertfile.nemo_action

To Uninstall the Nemo Action:

rm -rf ~/.local/share/nemo/actions/simplyconvertfile*

Verification

After installation, run simplyconvertfile from the terminal or find it in your application menu.