From 0388bbaa1499e58de5f971cf7b22621196eaec7b Mon Sep 17 00:00:00 2001 From: uriel1998 Date: Tue, 11 Dec 2012 17:25:12 -0500 Subject: [PATCH 1/2] Adding readme to repository --- readme.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 readme.md diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..5d8e62f --- /dev/null +++ b/readme.md @@ -0,0 +1,22 @@ +## POST.FM + +#About + +*post-fm* is a Perl script that submits information about your currently played track to Last.FM / Audioscrobbler. It’s primarily made for [http://onion.dynserv.net/~timo/cmus.html](CMUS), a ncurses based music player, but could be used as a general purpose scrobbler with only minor modifications. +License + +post-fm is published under the terms of the GNU General Public License (GPL), version 2. The full license can be found [http://www.gnu.org/licenses/gpl.txt](here). + +#Prerequisites + +The script requires the module LWP::UserAgent, which is usually found in a package called libwww-perl or something similar. Linux/BSD distributions should provide a prebuilt package. Otherwise, install it from [http://www.cpan.org/](CPAN). + +#Installation + +Simply copy the script to a place where CMUS can find it (~/.cmus/ for example) and make it executable. Then start CMUS and type + + :set status_display_program=/path/to/post-fm + +Please note that you have to use the absolute path and that $HOME/... or even ~/... won’t work. + +Now open the script with your favorite editor and replace the username and password placeholders at the top with your Last.FM login data. From 36cc790cc0dd4d17a1b79b00610321090d4a0be2 Mon Sep 17 00:00:00 2001 From: uriel1998 Date: Tue, 11 Dec 2012 17:28:12 -0500 Subject: [PATCH 2/2] Small formatting stuff. --- readme.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/readme.md b/readme.md index 5d8e62f..a92e589 100644 --- a/readme.md +++ b/readme.md @@ -2,10 +2,11 @@ #About -*post-fm* is a Perl script that submits information about your currently played track to Last.FM / Audioscrobbler. It’s primarily made for [http://onion.dynserv.net/~timo/cmus.html](CMUS), a ncurses based music player, but could be used as a general purpose scrobbler with only minor modifications. -License +*post-fm* is a Perl script that submits information about your currently played track to Last.FM / Audioscrobbler. It’s primarily made for [http://onion.dynserv.net/~timo/cmus.html](CMUS), a ncurses based music player, but could be used as a general purpose scrobbler with only minor modifications. -post-fm is published under the terms of the GNU General Public License (GPL), version 2. The full license can be found [http://www.gnu.org/licenses/gpl.txt](here). +#License + +**post-fm** is published under the terms of the GNU General Public License (GPL), version 2. The full license can be found [http://www.gnu.org/licenses/gpl.txt](here). #Prerequisites