[[HomePage]] > [[SoftwareIndex|Software Index]] > [[SoftwareMultimedia|Multimedia]] > [[pMusic]] > [[pMusicDoc|Documentation]]

{{image url="http://www.smokey01.com/zigbert/pmusic/wiki/pmusic_heading.png" link="pmusic" title="pMusic" alt="pMusic" height="80"}}


=====Searching in pMusic=====

The old fashion way to search for your music is to do a file search and filter out the audio files. This works perfect for small collections, but when things start to grow, we need more powerful tools to find what we searches for without having too many cups of coffee while we wait. Searching isn't hard, but quick search is more complex. We are talking about indexing - putting info of your files into a database to quickly find it when we search for it. The search is not done in your filesystem(s) - but inside the database, which is much faster. A deeper understanding of this structure is described in the article [[http://web.archive.org/web/20160913060503/http://blog.puppylinux.com/?viewDetailed=00024|pMusic DB and file format]].


==={{color text="The Search field" c="green"}}===

~As expected, there is a field to write requested searchstrings. It's a free search in the mean that every word is searched for individually.
~//**''nig tnt''**// finds the track //TNT - Desperate night//. As this shows, it isn't case sensitive.
~
~Placing a minus (**-**) in front of the searchstring removes items containing this string from the search result.
~//**''nig -tnt''**// does not find any TNT tracks.
~
~Execute search by pressing enter or the search button.
~
~The search field has 2 optional uses
~~- If you type a path it will start the builtin browser at the given location.
~~- If you type a web address, it will add the URL to the playqueue.
~
~When [[http://web.archive.org/web/20160912055625/http://blog.puppylinux.com/?viewDetailed=00033|searching youtube]] inside pMusic, there is a difference in how to specify the best search-string. Youtube has a advanced search-engine which gives result for __related items__. This means you can specify 'as much as possible' to get the closest result. pMusic has a simple search-engine, and requires the search-string to have a correct syntax. It must not be complete (not even the words) and it isn't case sensitive, but the search will fail if the search-string is misspelled. The consensus is: Search youtube, write whatever. - Else, search simple.


==={{color text="Where to search" c="green"}}===

~The search dock specifies what sources should be searched.
~
~~{{image url="http://www.smokey01.com/zigbert/pmusic/wiki/docSearch_1.png"}}
~
~The dock shows different sources
~~- **Tracks** is local audio files stored in the [[http://web.archive.org/web/20160913060503/http://blog.puppylinux.com/?viewDetailed=00024|database]]. The database holds a lot of data, and whatever info the database holds about a track will be a target for your search. E.g. You store your music in /dir/music/, and are searching for //**''Madonna Music''**// you will get all tracks because //**''Music''**// corresponds with directory name found in the database.
~~- **Playlist** is both internal album lists and your own m3u/pls playlist files.
~~- **Discography** searches Musicbrainz.org for artist and their albums. Chosen tracks are played either from local file or from Youtube.
~~- **Radio** searches the index holding all radio URL's. This index has to be downloaded.
~~- **Album art** looks inside the directory where pMusic stores downloaded album art. The placement is in the data storage defined in the preferences. Default is $HOME/.pmusic/. The result is not shown in the sourcelist (as the others), but as thumbs. Right-click on a thumb to setup this bar.
~~- **Youtube** searches [[http://youtube.com youtube.com]] via [[http://keepvid.com keepvid.com]]. The result shows maximum 10 items.
~~- **Jamendo** searches the index holding music from jamendo.com. This index has to be downloaded.
~~- **Podcast** searches the podcast index. This index has to be downloaded.
~~- **Lyrics** searches inside the downloaded lyrics files. This has to be turned on in the Preferences.
~~-The last option is a plain **file search**, and let's you specify directory to search in. This will find all files - also those not stored in the database. Normally all music is stored into the database, but in some cases, the user can override this, and a full-range file search is required. This kind of search is much slower than a search inside the database. pMusic uses [[pFilesearch]] as the file search engine.


===Misc===

~-Advanced filesearch is reachable from the **Music Sources** menu. This opens the [[pFilesearch]] gui, but the result is sent back to pMusic. pFilesearch is an optional [[pmusicInstall#hn_Dependencies|dependency]].
~-The plugin [[http://murga-linux.com/puppy/viewtopic.php?p=663132#663132 Search inside playlist files]] finds playlist files that contains the playing track.
~-Search random tracks depending on your requests is done by the **smartadd** function. Described in the article [[http://web.archive.org/web/20170502202522/http://blog.puppylinux.com/?viewDetailed=00027|Set playqueue]].


----
==Categories==
CategoryMultimedia
CategorySoftware