The gPodder podcast client.
Python Other
Switch branches/tags
harmattan/gpodder_3.8.5 harmattan/gpodder_3.8.4 harmattan/gpodder_3.8.3 harmattan/gpodder_3.8.2 harmattan/gpodder_3.8.1 harmattan/gpodder_3.8.0 harmattan/gpodder_3.7.0 harmattan/gpodder_3.6.1 harmattan/gpodder_3.6.0 harmattan/gpodder_3.5.2 harmattan/gpodder_3.5.1 harmattan/gpodder_3.5.0 harmattan/gpodder_3.4.0 harmattan/gpodder_3.3.0 harmattan/gpodder_3.2.2 harmattan/gpodder_3.2.1 harmattan/gpodder_3.2.0 harmattan/gpodder_3.1.2 harmattan/gpodder_3.1.1 harmattan/gpodder_3.1.0 harmattan/gpodder_3.0.4 harmattan/gpodder_3.0.3 harmattan/gpodder_3.0.2 harmattan/gpodder_3.0.1 harmattan/gpodder_3.0.0 gpodder-last-svn-commit gpodder-ipod-dbus gpodder-core gpodder-before-mygpoclient gpodder-3.9.3 gpodder-3.9.2 gpodder-3.9.1 gpodder-3.9.0 gpodder-3.8.5 gpodder-3.8.4 gpodder-3.8.3 gpodder-3.8.2 gpodder-3.8.1 gpodder-3.8.0 gpodder-3.7.0 gpodder-3.6.1 gpodder-3.6.0 gpodder-3.5.2 gpodder-3.5.1 gpodder-3.5.0 gpodder-3.4.0 gpodder-3.3.0 gpodder-3.2.0 gpodder-3.1.2 gpodder-3.1.1 gpodder-3.1.0 gpodder-3.0.4 gpodder-3.0.3 gpodder-3.0.2 gpodder-3.0.1 gpodder-3.0.0 gpodder-2.20.3 gpodder-2.20.2 gpodder-2.20.1 gpodder-2.20 gpodder-2.19 gpodder-2.18 gpodder-2.17 gpodder-2.16 gpodder-2.15 gpodder-2.14 gpodder-2.13 gpodder-2.12 gpodder-2.11 gpodder-2.10 gpodder-2.9 gpodder-2.8 gpodder-2.7 gpodder-2.6 gpodder-2.5 gpodder-2.4 gpodder-2.3 gpodder-2.2 gpodder-2.1 gpodder-2.0 gpodder-0.17.0 gpodder-0.16.1 gpodder-0.16.0 gpodder-0.15.2 gpodder-0.15.1 gpodder-0.15.0 gpodder-0.14.1 gpodder-0.14.0 gpodder-0.13.1 gpodder-0.13.0 gpodder-0.12.3 gpodder-0.12.2 gpodder-0.12.1 gpodder-0.12.0 gpodder-0.11.3 gpodder-0.11.2 gpodder-0.11.1 gpodder-0.11.0 gpodder-0.10.4 gpodder-0.10.3
Nothing to show
Latest commit c652813 Dec 16, 2017 @thp thp gPodder 3.9.5


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


             Copyright  2005-2017 Thomas Perl and the gPodder Team


    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
    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 <>.


    - Python 2.7.9 or newer  
    - Podcastparser 0.6.0 or newer
    - mygpoclient 1.7 or newer
    - Python D-Bus bindings

    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, you can use the script tools/ to
    install local copies of podcastparser and mygpoclient into "src/" from
    PyPI. With this, you get a self-contained gPodder CLI codebase.


    - PyGTK 2.16 or newer    


    - 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: python-gpod
    - Clickable links in GTK UI show notes: html5lib


    - help2man
    - intltool


    - python-minimock
    - python-coverage
    - desktop-file-utils


    To run tests, use...
        make unittest

    To set a specific python binary set PYTHON:
        PYTHON=python2 make unittest

    Tests in gPodder are written in two different ways:

       - doctests (see
       - unittests (see

    If you want to add doctests, simply write the doctest and make sure that
    the module appears in "doctest_modules" in src/gpodder/ For
    example, the doctests in src/gpodder/ are added as 'util' (the
    "gpodder" prefix must not be specified there).

    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/
        is tested by   src/gpodder/test/

    After you've added the test, make sure that the module appears in
    "test_modules" in src/gpodder/ - for the example above, the
    unittests in src/gpodder/test/ 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).


    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

        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 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/


    For Python 3 support, we recommend you use the "gtk3" branch [from a git clone]( There, gPodder has been updated to use to gtk3 and Python 3.


    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 : 
		Add and edit the following lines to alter the launch enviroment on OS X : 
			export GPODDER_HOME="$HOME/Library/Application Support/gPodder"
			export GPODDER_DOWNLOAD_DIR="$HOME/Library/Application Support/gPodder/download"


    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.


    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 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/"

    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:


    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.


    - Homepage               
    - Bug tracker            
    - Mailing list           
    - IRC channel                      #gpodder on

             Last updated: 2016-11-30 by Thomas Perl <>