View source for Amarok/Manual/Various/Moodbar/da

<languages/>

=== Stemningslinjen ===

'''Stemningslinjen''' vender officielt tilbage til '''Amarok''' med version 2.2.2. Den viser dig st spors "stemning", som du kan bruge til at finde ud af, om der sker noget interessant i nummeret.

In order for '''Amarok''' to analyze your music files to create moodbars, you will need the '''Moodbar''' program (see below for [[#Source Downloads|downloads]] and binary packages).  

The '''Moodbar''' package requires ''GStreamer'' and various plugins depending on the filetypes you use (see [[#Supported Filetypes|Supported filetypes]]).  You will '''not''' need the phonon-backend-gstreamer package to create .mood files.

There are two parts to the new '''Moodbar''' implementation: the '''Moodbar''' package, which contains a program that takes a music file and generates a .mood file, and support code in the '''Amarok''' source, which runs the binary and displays the Moodbar.  The '''Moodbar''' package depends on the ''GStreamer'' libraries.  Without the '''Moodbar''' package, Amarok cannot generate the moodbars for your music. 

As an alternative, there is a new script which will create moodbar files for tracks in an '''Amarok''' playlist; this is an exception to the above. The script needs nothing but Amarok to work, but it only creates the .mood files as they are played in the ''Playlist''.

The ''Moodbar'' is due to the work of Gavin Wood and Simon O'Keefe, who designed the algorithms; their original paper is [http://cratoo.de/amarok/ismir-crc.pdf here]. 

==== Summary of Requirements ====

* The '''Moodbar''' binary, in your PATH (it should be listed upon running {{Input|1=which moodbar}}from a console) -- Remember to configure the '''Moodbar''' package with {{Input|1=./configure --prefix=`pkg-config --variable=prefix gstreamer-0.10`}}

* The ''GStreamer'' 0.10 library and [[#Supported Filetypes|plugins]] for the formats you want '''Moodbar''' to be able to analyse.

* The ''Fastest Fourier Transform In The West'' (http://www.fftw.org) ''FFTW'' library version 3.0 or above (at least single-precision floating point version - libfftw3f) -- If your platform does not provide this for you or you need to compile your own version, remember to configure the ''FFTW'' package with {{Input|1=./configure --enable-single}}

* A version of '''Amarok''' with a <menuchoice>Use moods</menuchoice> option in the General section of the configuration screen. This means 1.4.4 or higher in the 1.4 series or 2.2.2 or higher in the 2.x series.

{{Info|Systems with package managers should automatically install the ''GStreamer'' plugins and ''FFTW'' along with '''Moodbar'''; this information is provided mostly for people who want or need to compile from source or manually install packages.}}

==== Usage ====

Currently .mood files must generated manually. To do this for your entire collection, use the [[#Moodbar File Generation Script|Moodbar File Generation Script]] described below.

To enable the display of moodbars in '''Amarok''', activate it in the configuration: <menuchoice>Settings -> Configure Amarok -> General -> Show Moodbar in Progress Slider</menuchoice>. Moodbars should now appear in the track sliders in the player window and the playlist window; there will also be a mood field that you may add to your playlist layouts.

====Installation====

===== Source Downloads =====

:Latest release: [http://pwsp.net/~qbob/moodbar-0.1.2.tar.gz moodbar-0.1.2.tar.gz] -- this is the '''Moodbar''' source package, which contains the '''Moodbar''' program (which generates .mood files from music files), and a ''GStreamer'' plugin that does the work. The '''Moodbar''' package  needs ''GStreamer'' 0.10.* installed, plus the 0.10.* version of [[#Supported Filetypes|various plugins]]. Be sure to install the '''Moodbar''' package into the '''same prefix''' as ''GStreamer'' -- follow the instructions in the INSTALL file.  

If you find any bugs, please submit a bug report at [http://bugs.kde.org bugs.kde.org].

===== Debian packages =====

A package for '''Moodbar''' is now available in Debian unstable. Simply run {{Input|1=apt-get install moodbar}}. You will likely also want to install ''gstreamer0.10-plugins-ugly'', ''gstreamer0.10-plugins-good'', and ''gstreamer0.10-plugins-bad'' for format support.

===== Kubuntu and Ubuntu packages =====

A package for '''Moodbar''' is available in the official package repository; just ensure the universe section is activated (which should be default anyway). Just install the package 'moodbar' with your preferred package manager (Kpackagekit, Aptitude, Adept, Synaptic). You will likely also want to install ''gstreamer0.10-plugins-ugly'', ''gstreamer0.10-plugins-good'', and ''gstreamer0.10-plugins-bad'' for format support.

Or, to install, paste this into '''Firefox''' or '''Konqueror''' and hit <keycap>Enter</keycap>.

{{Input|1=apt://moodbar,gstreamer0.10-plugins-ugly,gstreamer0.10-plugins-good,gstreamer0.10-plugins-bad?section=universe?refresh=yep}}

===== Gentoo ebuilds =====

'''Moodbar''' is available in Portage, simply {{Input|1=emerge moodbar}} Unofficial ebuilds are no longer required.

===== RPM builds =====

If you are a rpm-based distro user, you can build a .rpm using `rpmbuild` with latest 
[http://cvs.pld-linux.org/cgi-bin/cvsweb/SPECS/gstreamer-plugins-moodbar.spec gstreamer-plugins-moodbar.spec]. The binary package will be soon available for [http://pld-linux.org PLD-linux] distro.

===== Fedora =====

In Fedora 7 and higher (up to 16 as of this writing) '''Moodbar''' is available in the default repositories. Simply install it with your PackageKit GUI or with the following yum command:

{{Input|1=yum install moodbar}}

===== openSUSE packages =====

openSUSE 11.0 and later, automatically install the following packages:
*''gstreamer-0_10-fluendo-mp3''
*''gstreamer-0_10-plugins-base''

Also, if your songs contain ID3 tags, you must install 
*''gstreamer-0_10-plugins-good''

'''Moodbar Installation'''

1-Click Install for openSUSE 11.* - just choose your version and installation procedure will do the rest:
* [http://software.opensuse.org/ymp/home:dstoecker/openSUSE_11.2/moodbar.ymp openSUSE 11.2]
* [http://software.opensuse.org/ymp/home:dstoecker/openSUSE_11.1/moodbar.ymp openSUSE 11.1]

To install, add the correct repository for your version of openSUSE to '''YaST''' then make sure the following packages are installed:
* ''gstreamer-0_10-plugins-good''
* ''gstreamer-0_10-plugins-ugly''
* ''gstreamer-0_10-plugins-moodbar''
* ''mad''

For details on how to add repositories, see the [http://en.opensuse.org/SDB:Add_package_repositories openSUSE wiki].

If you are using the '''Smart''' software management tool, add the channel by entering the following at the command line, remember to change the URL to match your version of openSUSE: {{Input|1=smart channel --add http://software.opensuse.org/download/home:/d7/openSUSE_10.2/home:d7.repo}}Then enter {{Input|1=smart update home:d7}}You can now install the required packages by {{Input|1=smart install gstreamer10-plugins-moodbar}}Dependencies are resolved automatically.

===== Mandriva packages =====

First of all, you need to add PLF repositories, so visit [http://easyurpmi.zarb.org easyurpmi.zarb.org] and add them to your repositories list.
Then simply install the following packages:

* ''gstreamer0.10-moodbar''
* ''gstreamer0.10-plugins-ugly''
* ''gstreamer0.10-plugins-good''
* ''gstreamer0.10-plugins-bad''

===== Arch Linux =====

There is a PKGBUILD for '''Moodbar''' in the [http://aur.archlinux.org Arch User Repository (AUR)] available [http://aur.archlinux.org/packages.php?ID=6552 here].

For more information about the AUR and working with PKGBUILDs, see the [http://wiki.archlinux.org/index.php/AUR_User_Guidelines AUR User Guidelines].

===== FreeBSD =====

There is a port: [http://www.freshports.org/audio/gstreamer-plugins-moodbar audio/gstreamer-plugins-moodbar here].

To install the port: {{Input|1=cd /usr/ports/audio/gstreamer-plugins-moodbar/ && make install clean}}
To add the package: {{Input|1=pkg_add -r gstreamer-plugins-moodbar}}

==== Moodbar File Generation Script ====

Here is a simple bash script that will add .mood files to your entire collection. It adds mood files for all files matching the extensions in the current directory and all subdirectories, so it's best run from the base of your music directory. 

{{Input|1=
 <syntaxhighlight lang="bash" line>#!/bin/bash
 DIR=${1:-.}
 LAST=~/.moodbar-lastreadsong
 C_RET=0
 
 control_c()        # run if user hits control-c
 {
   echo "" > "$LAST"
   echo "Exiting..."
   exit
 }
 
 if [ -e "$LAST" ]; then
   read filetodelete < "$LAST"
   rm "$filetodelete" "$LAST"
 fi
 exec 9< <(find "$DIR" -type f -regextype posix-awk -iregex '.*\.(mp3|ogg|flac|wma)') # you may need to add m4a and mp4
 while read i
 do
   TEMP="${i%.*}.mood"
   OUTF=`echo "$TEMP" | sed 's#\(.*\)/\([^,]*\)#\1/.\2#'`
   trap 'control_c "$OUTF"' INT
   if [ ! -e "$OUTF" ] || [ "$i" -nt "$OUTF" ]; then
     moodbar -o "$OUTF" "$i" || { C_RET=1; echo "An error occurred!" >&2; }
   fi
 done <&9
 exec 9<&-
 
 exit $C_RET</syntaxhighlight>}}

Copy and paste the above into a text file named moodbar.sh in your music directory and run the following commands:
<!--}}-->{{Input|1=
 cd /path/to/music
 bash moodbar.sh
}}<!--{{-->

Alternatively if the above does not work, you may try:
<!--}}-->{{Input|1=
 chmod +x moodbar.sh
 ./moodbar.sh
}}<!--{{-->

This may take a very long time for large collections! Note that the moodbars will not appear in '''Amarok''' until '''Amarok''' rescans the collection. The generated <tt>mood</tt> files will be dotfiles (i.e., prefixed with a full stop), or hidden files - so keep this in mind if you can't find any generated mood files.

Based on the above script, an alternative for multicore CPUs:

{{Input|1=
 <syntaxhighlight lang="bash" line>#!/bin/bash
 NUMCPU="$(grep ^processor /proc/cpuinfo | wc -l)"
 
 find . -type f -regextype posix-awk -iregex '.*\.(mp3|ogg|flac|wma)' | while read i ; do
 
        while [ `jobs -p | wc -l` -ge $NUMCPU ] ; do
                sleep 0.1
        done
 
        TEMP="${i%.*}.mood"
        OUTF=`echo "$TEMP" | sed 's#\(.*\)/\([^,]*\)#\1/.\2#'`
        if [ ! -e "$OUTF" ] ; then
                moodbar -o "$OUTF" "$i" &
        fi
 done</syntaxhighlight>}}

There is another script at [https://github.com/aendruk/moodbar-preview-cli Github], which shows previews of the generated mood files on the command line while they are being generated. Read more about it at the [https://aendruk.wordpress.com/2011/02/13/moodbar-previews-on-the-command-line/ author's blog].

==== Troubleshooting ====

* If the '''Moodbar''' executable gives you a ''bus error'', that almost always means it can't decode (or can't find) your file.  Take a look at the [[#Supported Filetypes|supported file types]] below for ideas on which ''GStreamer'' plugins to install.  You can also try the command below to test whether ''GStreamer'' can decode your file:{{Input|1=gst-launch filesrc location=[file] ! decodebin ! fakesink}}

* If you are using the ffmpeg plugin to decode mp3s, you may also receive mysterious bus errors. The solution is to stop using the ffmpeg plugin, as it is extremely buggy -- use mad instead.

* If the '''Moodbar''' executable tells you that it can't find an element -- i.e, it gives an error message like {{Output|1=Could not create element of type fftwspectrum, please install it.}}-- that usually means that you either don't have the required plugins installed (see the plugin list [[#Supported Filetypes|here]]), or that you didn't install the '''Moodbar''' package in the same prefix as ''GStreamer''. If libmoodbar.so and libgstdecodebin.so are not in the same directory, then '''Moodbar''' is not installed in the same prefix as ''GStreamer''.  Please read the INSTALL file for instructions on how to configure the moodbar package correctly. Alternatively, ''if you know what you're doing,'' it may be easier for you to take a look at the <tt>GST_PLUGIN_PATH</tt> environment variable.

* If you're wondering why the '''Moodbar''' isn't working, either not working at all or not working for a particular file, run the command below, where [file] is a music file:{{Input|1=moodbar -o test.mood [file]}}

* If you have multiple versions of ''GStreamer'' installed, make sure all of the required plugins are installed '''for version 0.10.*''' -- different versions ''cannot'' use each other's plugins.

==== Supported Filetypes ====

You will need various ''Gstreamer'' plugins to enable '''Moodbar''' to analyze your files. Here is a list of the plugins you will need; make sure to install the '''0.10.* version''' of each plugin:

{| border="1" cellpadding="5" <!--}-->
! Filetype !! Required Plugin !! Note
|-
| All || gstreamer-0.10.*, gst-plugins-base, gst-plugins-good
|-
| mp3 || gst-plugins-mad (in gst-plugins-ugly) || ffmpeg plugin has problems; ''do not use'' for mp3
|-
| ogg || gst-plugins-vorbis, gst-plugins-ogg
|-
| flac || gst-plugins-flac
|-
| mp4 || gst-plugins-faad, gst-plugins-bad
|-
| musepack || gst-plugins-musepack
|-
| wma || gst-plugins-ffmpeg
|} <!--{-->

==== Screenshots ====

[[Image:Amarok2_moodbar.png|600px|center|Moodbar in progress slider in Amarok 2]]


{{Prevnext2
| prevpage=Special:myLanguage/Amarok/Manual/Various | nextpage=Special:myLanguage/Amarok/Manual/Various/AmarokOnOtherPlatforms
| prevtext=Various | nexttext=Amarok on Other Platforms
| index=Special:myLanguage/Amarok/Manual | indextext=Back to Menu
}}

[[Category:Amarok]]
[[Category:Multimedia]]
[[Category:Tutorials]]