Source

gSharkDown / README

.. -*- restructuredtext -*-

gSharkDown
==========

It is a easy to use GNOME Desktop application for playing and
downloading audio files from the grooveshark audioservice. 

.. image:: http://i.imgur.com/je5bz.png

Features
========

Some of the importart features:
    - GNOME Desktop integration
    - Ease to use
    - Playlist with loop option
    - Song information with album picture
    - Remembers the playlist on exit
    - Notifications on track change *(disabled by default)*
    - Multimedia Keys support under GNOME Desktop
    - Saving/Opening playlist in own format
    - Searching for Lyrics in two services: lyrdb and chartlyrics
    - Last.FM scrobbling *(disabled by default)*
    - Reordable playlist (thanks to eagleoneraptor)
    - Multiple items add to playlist (thanks to eagleoneraptor)
    - Multiple downloads (thanks to eagleoneraptor)
    

Dependenices
============

gSharkDown depends on the following libraries:
    - pygtk2 (python-gtk2 == 2.18)
    - ConfigObj (python-configobj)
    - python-gobject
    - python-gstreamer0.10
    - pycurl (since gsd version 0.4)
    - pynotofy (python-notify)
    - pylast (for the Last.FM scrobbling)

Downloading for your Distribution
=================================

For Ubuntu/Debian:

You can use the provided packages in the Downloads section or just add the 
lffl PPA:

**For Ubuntu**

    sudo add-apt-repository ppa:ferramroberto/gsharkdown

    sudo apt-get update

    sudo apt-get install gsharkdown


**For Deabin**

    sudo echo "deb http://ppa.launchpad.net/ferramroberto/gsharkdown/ubuntu lucid main " | sudo tee -a /etc/apt/sources.list

    sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com --recv-key 0xb725097b3acc3965

    sudo apt-get update 

    sudo apt-get install gsharkdown \\



**For ArchLinux:**

    There are 2 AUR packages one is the default and gsharkdown-lite removed the pylast dependency `gsharkdown <http://aur.archlinux.org/packages.php?O=0&K=gsharkdown&do_Search=Go>`_

**For Fedora/openSUSE** and other RPM based distributions:

    There is a rpm package in the downloads section, created with alien (converting the .deb package to .rpm)


Licenses and Thanks
===================

gSharkDown is licensed under the GNU GPL v.3 License

The groove.py library is part of the groove-dl application from
jacktheripper51 (George Stephanos) and can be found at github on the following
webaddress: `groove-dl@github <https://github.com/jacktheripper51/groove-dl>`_

Special thanks to Damián Nohales for his commits.

Any comments and help are welcome
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.