From 094aea4c657a77e6ad8bb0a55bf8fc6c9fc956d2 Mon Sep 17 00:00:00 2001 From: l-koehler Date: Sat, 6 Jan 2024 10:09:30 +0100 Subject: [PATCH] improve install instructions (github.com/Botspot/pi-apps/issues/2513) --- README.md | 21 ++++++++++++--------- share/ffconverter.desktop | 3 ++- 2 files changed, 14 insertions(+), 10 deletions(-) mode change 100644 => 100755 share/ffconverter.desktop diff --git a/README.md b/README.md index 13e2565..398ddfe 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,7 @@ options, for example flipping the image or selecting codecs, in the tabs. #### Installation Install the `ffconverter` package from PyPI. `pip` works on most distros and should be the simplest choice. + ```sh pip install ffconverter ``` @@ -32,16 +33,15 @@ pip install ffconverter #### Troubleshooting On some distros (externally managed environments, Arch, Debian), `pip` will not work. In this case, you should use `pipx`. + ```sh sudo PIPX_HOME=/usr/local/pipx PIPX_BIN_DIR=/usr/local/bin pipx install --system-site-packages ffconverter +sudo ln -sf /usr/local/pipx/venvs/ffconverter/share/applications/ffconverter.desktop /usr/local/share/applications/ffconverter.desktop +sudo ln -sf /usr/local/pipx/venvs/ffconverter/share/pixmaps/ffconverter.png /usr/local/share/icons/ffconverter.png ``` -In some cases, the program might not appear in your installed applications, but -the `ffconverter` command will be available. In this case, run: -```sh -wget https://raw.githubusercontent.com/l-koehler/FF-converter/master/share/ffconverter.desktop -O ~/.local/share/applications/ffconverter.desktop -``` -This command should add ffconverter to your installed applications, so you can -access the program without the terminal. + +The last two commands are needed to add the program to your installed +applications, but the `ffconverter` command should be available without them. #### Uninstall Simply run: @@ -53,6 +53,9 @@ Adjust this command if you used something other than `pip` to install. #### Run without installing You can launch the application without installing it by running the launcher script: + ```sh -python3 launcher -``` \ No newline at end of file +git clone https://github.com/l-koehler/ff-converter +cd ./ff-converter +python3 ./launcher +``` diff --git a/share/ffconverter.desktop b/share/ffconverter.desktop old mode 100644 new mode 100755 index 99e2634..1c78773 --- a/share/ffconverter.desktop +++ b/share/ffconverter.desktop @@ -1,6 +1,7 @@ +#!/usr/bin/env xdg-open [Desktop Entry] Type=Application -Version=2.0.1 +Version=2.1.3 Name=FF Converter GenericName=File Format Converter GenericName[pt]=Conversor de ficheiros