gpodder / gpodder-osx-bundle

generate a native gtk+ quartz OS X application

      ___         _    _           ____
 __ _| _ \___  __| |__| |___ _ _  |__ /
/ _` |  _/ _ \/ _` / _` / -_) '_|  |_ \
\__, |_| \___/\__,_\__,_\___|_|   |___/
|___/
        Media aggregator and podcast client

---

Copyright 2005-2022 The gPodder Team

License

gPodder is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

gPodder is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Dependencies

• Python 3.7 or newer
• Podcastparser 0.6.0 or newer
• mygpoclient 1.7 or newer
• requests 2.24.0 or newer
• dbus-python

As an alternative to python-dbus on Mac OS X and Windows, you can use the dummy (no-op) D-Bus module provided in "tools/fake-dbus-module/".

For quick testing, see Run from Git to install dependencies.

GTK3 UI - Additional Dependencies

• PyGObject 3.22.0 or newer
• GTK+3 3.16 or newer

Optional Dependencies

• Bluetooth file sending: gnome-obex-send or bluetooth-sendto
• Size detection on Windows: PyWin32
• Native OS X support: ige-mac-integration
• MP3 Player Sync Support: python-eyed3 (0.7 or newer)
• iPod Sync Support: libgpod (tested with 0.8.3)
• Clickable links in GTK UI show notes: html5lib
• HTML show notes: WebKit2 gobject bindings (webkit2gtk, webkitgtk4 or gir1.2-webkit2-4.0 packages).
• Better Youtube support (> 15 entries in feeds, download audio-only): youtube_dl or yt-dlp

Build Dependencies

• help2man
• intltool

Test Dependencies

• python-minimock
• pytest
• pytest-httpserver
• pytest-cov
• desktop-file-utils

Testing

To run tests, use...

make unittest

To set a specific python binary set PYTHON:

PYTHON=python3 make unittest

Tests in gPodder are written in two different ways:

• doctests
• unittests

If you want to add doctests, simply write the doctest and make sure that the module appears after --doctest-modules in pytest.ini. If you add tests to any module in src/gpodder you have nothing to do.

If you want to add unit tests for a specific module (ex: gpodder.model), you should add the tests as gpodder.test.model, or in other words:

The file:       src/gpodder/model.py
is tested by:   src/gpodder/test/model.py

After you've added the test, make sure that the module appears in "test_modules" in src/gpodder/unittests.py - for the example above, the unittests in src/gpodder/test/model.py are added as 'model'. For unit tests, coverage reporting happens for the tested module (that's why the test module name should mirror the module to be tested).

Running and Installation

To run gPodder from source, use..

bin/gpodder              # for the Gtk+ UI
bin/gpo                  # for the command-line interface

To install gPodder system-wide, use make install. By default, this will install all UIs and all translations. The following environment variables are processed by setup.py:

LINGUAS                  space-separated list of languages to install
GPODDER_INSTALL_UIS      space-separated list of UIs to install
GPODDER_MANPATH_NO_SHARE if set, install manpages to $PREFIX/man/man1

See setup.py for a list of recognized UIs.

Example: Install the CLI and Gtk UI with German and Dutch translations:

export LINGUAS="de nl"
export GPODDER_INSTALL_UIS="cli gtk"
make install

The "make install" target also supports DESTDIR and PREFIX for installing into an alternative root (default /) and prefix (default /usr):

make install DESTDIR=tmp/ PREFIX=/usr/local/

Debian and Ubuntu use dist-packages instead of site-packages for third party installs, so you'll want something like:

sudo python3 setup.py install --root / --prefix /usr/local --optimize=1 --install-lib=/usr/local/lib/python3.10/dist-packages

In fact, first try running python -c "import sys; print(sys.path)" to check what is the exact path. It depends on your version of python.

Portable Mode / Roaming Profiles

The run-time environment variable GPODDER_HOME is used to set the location for storing the database and downloaded files.

This can be used for multiple configurations or to store the download directory directly on a MP3 player or USB disk:

export GPODDER_HOME=/media/usbdisk/gpodder-data/

OS X Specific Notes

• default GPODDER_HOME="$HOME/Library/Application Support/gPodder"
• default GPODDER_DOWNLOAD_DIR="$HOME/Library/Application Support/gPodder/download"

These settings may be modified by editing the following file of the .app :

/Applications/gPodder.app/Contents/MacOSX/_launcher

Add and edit the following lines to alter the launch environment on OS X :

export GPODDER_HOME="$HOME/Library/Application Support/gPodder"
export GPODDER_DOWNLOAD_DIR="$HOME/Library/Application Support/gPodder/download"

Changing the Download Directory

The run-time environment variable GPODDER_DOWNLOAD_DIR is used to set the location for storing the downloads only (independent of the data directory GPODDER_HOME):

export GPODDER_DOWNLOAD_DIR=/media/BigDisk/Podcasts/

In this case, the database and settings will be stored in the default location, with the downloads stored in /media/BigDisk/Podcasts/.

Another example would be to set both environment variables:

export GPODDER_HOME=~/.config/gpodder/
export GPODDER_DOWNLOAD_DIR=~/Podcasts/

This will store the database and settings files in ~/.config/gpodder/ and the downloads in ~/Podcasts/. If GPODDER_DOWNLOAD_DIR is not set, $GPODDER_HOME/Downloads/ will be used if it is set.

Logging

By default, gPodder writes log files to $GPODDER_HOME/Logs/ and removes them after a certain amount of times. To avoid this behavior, you can set the environment variable GPODDER_WRITE_LOGS to "no", e.g:

export GPODDER_WRITE_LOGS=no

Extensions

Extensions are normally loaded from gPodder's "extensions/" folder (in share/gpodder/extensions/) and from $GPODDER_HOME/Extensions/ - you can override this by setting an environment variable:

export GPODDER_EXTENSIONS="/path/to/extension1.py extension2.py"

In addition to that, if you want to disable loading of all extensions, you can do this by setting the following environment variable to a non- empty value:

export GPODDER_DISABLE_EXTENSIONS=yes

If you want to report a bug, please try to disable all extensions and check if the bug still appears to see if an extension causes the bug.

More Information

• Homepage: http://gpodder.org/
• Bug tracker: https://github.com/gpodder/gpodder/issues
• Mailing list: http://freelists.org/list/gpodder
• IRC channel: #gpodder on irc.libera.chat

gpodder-osx-bundle's Issues

Command-line interface does not seem to be included

Running gpo in Terminal results in command not found: gpo.

I have gPodder installed via homebrew cask, they pull gPodder from SourceForge it appears: https://github.com/caskroom/homebrew-cask/blob/master/Casks/gpodder.rb

The command-line interface should be included with the package and possible to use as described here: https://gpodder.github.io/docs/user-manual.html#command-line-interface

Gatekeeper signing on macOS

gPodder for macOS is currently not signed, so Gatekeeper displays a warning/error message when users attempt to run the application. This prevents gPodder from being used in environments where users are not permitted to disable Gatekeeper.

Is it possible to get gPodder signed? Thank you :-)

Errors building dependencies on OSX 10.11

Hi @elelay,

I'm trying to build gPodder 3.9.0 on OSX 10.11.2 (Xcode 7.3), but ran into issues building the dependencies. bootstrap.sh worked fine, but build.sh prints this:

➜  gpodder-osx-bundle git:(dev) ✗ ./build.sh
jhbuild build: failed to parse quodlibet: [Errno 2] No such file or directory: 'quodlibet'
W: Circular dependencies detected: meta-bootstrap -> xz -> automake -> automake
W: Circular dependencies detected: meta-bootstrap -> xz -> libtool -> libtool
W: bash has a dependency on unknown "readline" module
*** Checking out automake *** [1/22]
curl --continue-at - -L ftp://ftp.gnu.org/gnu/automake/automake-1.15.tar.gz -o /Users/u/proj/py/gpodder-osx-bundle/_home/jhbuild_checkoutroot/pkgs/automake-1.15.tar.gz
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 2191k  100 2191k    0     0   300k      0  0:00:07  0:00:07 --:--:--  300k
gzip -dc "/Users/u/proj/py/gpodder-osx-bundle/_home/jhbuild_checkoutroot/pkgs/automake-1.15.tar.gz" | tar xf -
*** Configuring automake *** [1/22]
./configure --prefix /Users/u/proj/py/gpodder-osx-bundle/_home/jhbuild_prefix
./configure: line 154: /Users/u/proj/py/gpodder-osx-bundle/_home/jhbuild_prefix/bin/bash: No such file or directory
./configure: line 154: exec: /Users/u/proj/py/gpodder-osx-bundle/_home/jhbuild_prefix/bin/bash: cannot execute: No such file or directory
*** Error during phase configure of automake: ########## Error running ./configure --prefix /Users/u/proj/py/gpodder-osx-bundle/_home/jhbuild_prefix    *** [1/22]

  [1] Rerun phase configure
  [2] Ignore error and continue to build
  [3] Give up on module
  [4] Start shell
  [5] Reload configuration
  [6] Go to phase "wipe directory and start over"
  [7] Go to phase "clean"
  [8] Go to phase "distclean"
choice:

the first error line is from jhbuild build autoconf --nodeps, the rest is jhbuild bootstrap. Tried with and without homebrew in $PATH — the same result.

Any ideas how to fix this?

Please include the mutagen python library in the bundle

Could you please include the mutagen python ID3 library in the next release of gpodder for OS/X? It's pure python, so there shouldn't be any dependencies, and without it the "retag episodes" plugin doesn't work. (I would issue a pull request, but I've given up on trying to build gpodder from source on OS/X, it seems incomprehensible.)

Have you considered moving this repository under the gPodder organization?

I didn't know this project existed and was an integral part of gPodder releases until gpodder/gpodder#320. Clearly you are the maintainer of this project, and perhaps the solution is just to add more links to this project in documentation.

However, I was wondering if you had considered moving the project into the gPodder organization? That way it would appear with the other gPodder related repositories when people look at the organization page.

change default gPodder home location

~/Library is now hidden by default in Finder.

So going back to ~/gPodder would make sense.

@thp, what do you think?

Not working on 10.7.4 (Symbol not found: _iconv)

When I start gPodder.app/Contents/MacOS/gPodder on the command line, I get the following traceback:

Traceback (most recent call last):
File "gPodder.app/Contents/Resources/bin/gpodder", line 175, in
main()
File "gPodder.app/Contents/Resources/bin/gpodder", line 168, in main
from gpodder.gtkui import main
File "/Users/thp/Desktop/gPodder.app/Contents/Resources/lib/python2.7/site-packages/gpodder/gtkui/main.py", line 22, in
import gtk
File "/Users/thp/Desktop/gPodder.app/Contents/Resources/lib/python2.7/site-packages/gtk-2.0/gtk/init.py", line 30, in
import gobject as _gobject
File "/Users/thp/Desktop/gPodder.app/Contents/Resources/lib/python2.7/site-packages/gobject/init.py", line 26, in
from glib import spawn_async, idle_add, timeout_add, timeout_add_seconds,
File "/Users/thp/Desktop/gPodder.app/Contents/Resources/lib/python2.7/site-packages/glib/init.py", line 22, in
from glib._glib import *
ImportError: dlopen(/Users/thp/Desktop/gPodder.app/Contents/Resources/lib/python2.7/site-packages/glib/_glib.so, 2): Symbol not found: _iconv
Referenced from: /usr/lib/libcups.2.dylib
Expected in: /Users/thp/Desktop/gPodder.app/Contents/Resources/lib/libiconv.2.dylib
in /usr/lib/libcups.2.dylib

Update dependencies

After our latest updates (#3), it'd be great to update the dependencies. openssl is really old.

I think we can download new modules from https://git.gnome.org/browse/gtk-osx/tree/modulesets-stable and try the build.

gpodder_dont_check_display.patch is no longer needed

gpodder/gpodder#984 bypasses the DISPLAY check if gpodder.ui.osx, removing the need for this patch. I could probably remove the file myself but won't because I have no way to test it.

https://github.com/gpodder/gpodder-osx-bundle/blob/master/modulesets/patches/gpodder_dont_check_display.patch