How to install and use it?

PengjuXu commented 6 years ago

Hi,

Thanks for this great GUI tool! But exactly how to install and use it?

alpernebbi commented 6 years ago

You should be able to install it with a simple pip install git-annex-metadata-gui in most cases, but sometimes the dependencies cause some problems.

If you're using Debian (or a derivative), you can install the system dependencies with:

# apt install git-annex python3-pip python3-pyqt5 python3-pygit2

At this point, you should be able to run these two without any errors:

$ python3 -c 'import PyQt5, pygit2'
$ git-annex version --raw

Then run:

$ pip3 install --user --no-deps git-annex-adapter git-annex-metadata-gui

Normally, pip tries to re-build pygit2 and complains that it can't. It also downloads a version of PyQt5 that doesn't support system themes, so the entire thing looks ugly. Since we already installed and verified we can use system-wide versions of these, the --no-deps flag lets us skip re-installing them.

This installs both my projects and creates a ~/.local/bin/git-annex-metadata-gui file, so you can run git-annex-metadata-gui from a terminal.

I hope I could help. Feel free to ask if anything goes wrong, or there is something unclear.

PengjuXu commented 6 years ago

@alpernebbi Thanks for instruction!

I tried on Debian but did not succeed.

pip3 install git-annex-metadata-gui
  Could not find any downloads that satisfy the requirement PyQt5 (from git-annex-metadata-gui)
sudo apt install python3-pyqt5
pip3 install git-annex-metadata-gui
  Could not find any downloads that satisfy the requirement PyQt5 (from git-annex-metadata-gui)
python3 -c 'import PyQt5, pygit2'
  ImportError: No module named 'pygit2'

I had success with Manjaro Linux:

install system pkg libgit2 first
sudo pip install git-annex-metadata-gui
  installed to /usr/bin/git-annex-metadata-gui
in /usr/lib/python/site-packages/
  changed modes of many related files and dirs  "ugo+rx"

alpernebbi / git-annex-metadata-gui

How to install and use it? #10