Skip to content

Commit

Permalink
Add some hints about solving installation problems to readme
Browse files Browse the repository at this point in the history
Signed-off-by: Christopher Arndt <chris@chrisarndt.de>
  • Loading branch information
SpotlightKid committed Sep 4, 2018
1 parent c39a407 commit 5587aef
Showing 1 changed file with 22 additions and 3 deletions.
25 changes: 22 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,9 +93,6 @@ This will install the `jack-select` program, the `jackselect` Python package,
the `jack-select.1` man page and the `jack-select.desktop` file and the
`jack-select.png` icon to provide a desktop start menu entry. It will also
install the required Python dependencies if they haven't been installed yet.
Installing `PyGObject` probably won't work this way, so make sure it is
installed some other way beforehand, e.g. via your distributions package
management.

If you want to install jack-select only for the current user, replace the
last command above with:
Expand All @@ -108,6 +105,28 @@ You can start jack-select from your desktop's XDG-compatible start menu or add
it to your autostart folder (e.g. `~/.config/autostart`) to have it started
along your with your desktop.

**Note:**
If you do not have installed `PyGObject` and/or `dbus-python` via your
distribution's package system yet, running the install command given above will
try to install them via Python setuptools from the Python Package Index (PyPI).
This will most likely require a compiler and some development packages to be
installed, since not all indirect dependencies are available on PyPI as binary
wheels for Linux. If this fails, try installing the packages `build-essential`,
`python-dev` and `libcairo2-dev` (assuming your Linux distribution is a
debian/Ubuntu variant) and try again.

If `dbus-python` is installed via your distribution's package system, you may
get the following error when running jack-select:

pkg_resources.DistributionNotFound: The 'dbus-python' distribution was not found and is required by jack-select

This means that `dbus-python` was not installed in a setuptools-compatible way.
Unfortunately this seems to be the case on most major Linux distributions.
As a workaround, you can install a working versin `dbus-python` from PyPI
only for your current user:

pip install --user dbus-python


Requirements
------------
Expand Down

0 comments on commit 5587aef

Please sign in to comment.