Differences

This shows you the differences between two versions of the page.

--- plugins:artistinfo [2010/09/29 12:03] – ochosi
+++ plugins:artistinfo [2022/05/23 01:30] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Artistinfo Plugin. ======
+== Author/Maintainer ==
+Authors: Simon Steinbeiß and Pasi Lallinaho\\
+Maintainer: Simon Steinbeiß
+== Short description ==
+This plugin displays artist information, partly from within gmusicbrowser itself, but mostly retrieved from [[http://www.last.fm/home|last.fm]] via its [[http://www.last.fm/api|api]].
-This plugin displays artist information, partly from within gmusicbrowser itself, partly retrieved from the internet.
+== Usage ==
 After activating this plugin you can either add it to your layout either by adding the widget //PluginArtistinfo// to your layout-file (usually stored in ~/.config/gmusicbrowser/layouts) or if by right-click adding it to your layouts context-tabs. E.g. in the //Lists, Library and Context// layout you can add the plugin-tab by right-clicking one of the existing lists (Playlist, Queue, Album, Lyrics etc.) and choosing //Open Context page > Artistinfo//.
@@ Line 10: / Line 14: @@
 Below this section the plugin displays information retrieved from last.fm, the **biographical data**, **the upcoming events** and in a separate tab **weblinks** to search different webpages for the playing artist in your browser. The biographical information can be saved locally (settings below), the events will always be retrieved live as they are always subject to change.
-This plugin has no additional dependencies.
+In the **settings dialog** of this plugin, you can change whether/where local data should be stored (only for biography) and the artist-picture size (as seen below in the screenshots' upper left corner).\\
+Furthermore the event-format can be customized by using the tags from last.fm's [[http://www.last.fm/api/show/?service=117|artist.getEvents]] api with a leading "%", e.g. "%title" or "%city". For more tags check out [[http://ws.audioscrobbler.com/2.0/?method=artist.getevents&artist=Cher&api_key=b25b959554ed76058ac220b7b2e0a026|this sample]]. If you want to add a linebreak, use "\\". All in all, a custom format could look like this:\\
+  %headliner playing at %name\\%attendance people attending\\in %city (%country), on %startDate\\\\
+__sample output__:\\
+  Devendra Banhart playing at O2 Arena
+people attending
+  in London (United Kingdom), on Wed, 01 Dec 2010
+  Devendra Banhart playing at Cardiff International Arena
+people attending
+  Cardiff (United Kingdom), on Thu, 09 Dec 2010
+  ...
+== Screenshots ==
+{{:plugins:artistinfo_biography.png?150|}} {{:plugins:artistinfo_events.png?150|}} {{:plugins:artistinfo_web.png?150|}}
+== Dependencies ==
+The only additional dependency are the icons needed for the weblinks page. ([[http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/icon_source|Source and license information.]])
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-allmusic.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-amazon.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-discogs.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-google.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-lastfm.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-pitchfork.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-wikipedia.png}}
+{{http://github.com/ochosi/gmusicbrowser/raw/master/pix/elementary/artistinfo-youtube.png}}
+Alternatively you can use the [[http://github.com/ochosi/gmusicbrowser/tree/master/pix/elementary/|elementary icon-theme]] which already contains these icons.
+== Installation ==
+You can download the latest version of the plugin from its git repository: http://github.com/ochosi/gmusicbrowser
+You can also use this link to download the file directly: [[http://github.com/ochosi/gmusicbrowser/raw/master/plugins/artistinfo.pm|artistinfo.pm]]
+After downloading the file, move it to your gmusicbrowser-plugins-directory, either in ///home/$USER/.config/gmusicbrowser/plugins// - or, if you want all users in your operating system be able to use the plugin in ///usr/share/gmusicbrowser/plugins//. (You might require superuser rights for the second option. E.g. "//sudo mv artistinfo.pm /usr/share/gmusicbrowser/plugins//" or use "//su//".)