This page documents how the features provided by the 'nepomuksearch' kioslave.
Nepomuk allows the creation of custom search folders via the 'nepomuksearch' kioslave. This kioslave can understand a number of different queries based on the custom Nepomuk query language.
The syntax for using the kioslave is as follows - nepomuksearch:/?query='Query' or nepomuksearch:/Query. Here "Query" is the special Nepomuk query.
Though Nepomuk stores a lot of different information, this kioslave will only show information that can be represented as a file.
The simplest queries are just simple strings that can be used for full text search. Example - nepomuksearch:/Coldplay will search for all the files which contain the word "Coldplay".
You can look for files which have been tagged with certain tags by writing the following query -
Combining different Queries
Multiple queries can be combined with the AND and OR operators. For example - Searching for a file with multiple tags - nepomuksearch:/hasTag:KDE and hasTag:Fire.
Certain properties of the query can be negated using the - operator.
Example - nepomuksearch:/hasTag:KDE and -hasTag:Fire. This will search for all the files which have the tag KDE and do not have the Fire.
hasTag is just one of the many properties that can be used for searching in Nepomuk. Here is a list of some of the most commonly used properties -
- title: - The title of the file. Useful for documents
- filename - The filename
- duration: - Has to be written in seconds
- channels - Generally 1/2
Nepomuk offers a variety of different operators that can be used be used:
- Contains :
- Less <
- Equal =
- Greater >
- LessEqual <=
- GreaterEqual >=
Example - nepomuksearch:/rating<4 and width=320. This will search for all the files which have a rating less than 4 and a width of 320.
The simplest way to test a query is through the command line
kioclient list 'nepomuksearch:/rating<5'
. This will print out all the files with a rating < 5. Once you are satisfied with the query you can run it in the proper application by typing
kioclient exec 'nepomuksearch:/rating<5'