README

   1                                _
   2                               | \      |   |
   3                            _  |_/ _   _|  _|  _   _
   4                           / \ |  / \ / | / | /_| |
   5                           \_/ |  \_/ \_| \_| \_  |
   6                          ._/ http://www.gpodder.org/
   7
   8            - -- == === ================================= === == -- -
   9              Copyright  2005-2008 Thomas Perl and the gPodder Team
  10
  11  ==========================
  12  License (see COPYING file)
  13  ==========================
  14
  15  gPodder is free software; you can redistribute it and/or modify
  16  it under the terms of the GNU General Public License as published by
  17  the Free Software Foundation; either version 3 of the License, or
  18  (at your option) any later version.
  19
  20  gPodder is distributed in the hope that it will be useful,
  21  but WITHOUT ANY WARRANTY; without even the implied warranty of
  22  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23  GNU General Public License for more details.
  24
  25  You should have received a copy of the GNU General Public License
  26  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  27
  28
  29  ============
  30  Dependencies
  31  ============
  32
  33    * python (>= 2.4)
  34    * python-gtk2 (minimum 2.6, but >= 2.12 recommended)
  35    * python-glade2
  36    * python-feedparser
  37    * python-pysqlite2 (already included in Python 2.5, but needed for 2.4)
  38
  39  Additional dependencies for iPod synchronization support:
  40
  41    * One of the following metadata libraries:
  42      - python-pymad (preferred; MAD MP3 decoder Python bindings)
  43      - python-eyed3 (alternative to pymad; eyeD3 Python bindings)
  44    * python-gpod (libgpod's Python bindings)
  45    * mplayer (OPTIONAL; if you want video podcast length detection)
  46
  47  Additional dependencies for MTP-based device synchronization support:
  48
  49    * python-pymtp (libmtp's Python bindings; nick125.com/projects/pymtp)
  50
  51  Additional dependencies for "Update tags after download":
  52
  53    * python-eyed3 (for updating MP3 files)
  54    * vorbis-tools (for updating OGG files)
  55
  56  Additional dependencies for converting OGGs to MP3s on iPod sync:
  57
  58    * oggdec (for decoding OGG files)
  59    * lame (for encoding MP3 files)
  60
  61  Additional dependencies if you want Bluetooth file send support:
  62
  63    * python-bluez OR hcitool (for detecting nearby devices)
  64    * gnome-obex-send OR bluetooth-sendto (for the file send operation)
  65
  66  Additional dependencies if you want Rockbox Cover Art syncing:
  67
  68    * python-imaging (Python Imaging Library, PIL)
  69
  70  Additional dependencies if you want to install from source:
  71
  72    * help2man
  73    * python-dev
  74    * intltool
  75    * imagemagick
  76
  77  ============
  78  Installation
  79  ============
  80
  81  Extract the tar archive somewhere into your home directory and cd into
  82  the directory where you extracted it, for example:
  83
  84    tar xzvf gpodder-0.13.0.tar.gz
  85    cd gpodder-0.13.0/
  86    make install
  87
  88  If you have any problems, please visit the gPodder website or mail the
  89  gPodder mailing list (see below for more information).
  90
  91  =========================================
  92  Feature requests, bug reports and patches
  93  =========================================
  94
  95  Feature requests, bug report and patches should all be filed in our
  96  Bugzilla at http://bugs.gpodder.org - for general discussion and questions,
  97  please send a message to gpodder-devel (this is a subscriber-only list, so
  98  you have to subscribe first before sending mail there).
  99
 100  For up to date information about gPodder, see the website and Wiki.
 101
 102    Homepage:       http://www.gpodder.org/
 103    Wiki:           http://wiki.gpodder.org/
 104    Bugzilla:       http://bugs.gpodder.org/
 105
 106    FAQs:           http://wiki.gpodder.org/wiki/FAQs
 107    Mailing List:   gpodder-devel@berlios.de
 108    IRC Channel:    #gpodder on FreeNode (irc.freenode.net)
 109
 110  Have fun with gPodder!
 111  Thomas Perl <thpinfo.com>
 112