Baloo: Difference between revisions

From KDE Community Wiki
No edit summary
No edit summary
(22 intermediate revisions by 9 users not shown)
Line 1: Line 1:
Baloo is the next generation of the Nepomuk project. It's responsible for handling user metadata such as tags, rating and comments. It also handles indexing and searching for files, emails, contacts, and so on. Baloo aims to be lighter on resources and more reliable than its parent project.
[[File:Mascot konqi-support-search.png|thumbnail|right|Help [[Konqi]] find what he wants!]]
[https://projects.kde.org/projects/frameworks/baloo Baloo] is the file indexing and file search framework for KDE Plasma.


== What's wrong with Nepomuk? ==
:Mailing List: [email protected] ([https://mail.kde.org/mailman/listinfo/kde-devel info page])
:IRC Channel: #kde-baloo on freenode


The Nepomuk project started as a research project in the European Union. The goal was to explore the use of relations between data for finding what you are looking for. It was build completely on top of RDF. While RDF is a great from a theoretical point of view, it is not the simplest tool to understand or optimize. The databases which currently exist for RDF are not suited for desktop use.
Baloo focuses on providing a very small memory footprint along with with extremely fast searching.


The Nepomuk developers have tried very hard over the last years to optimize the indexing and searching infrastructure, and they have now come to the conclusion that Nepomuk cannot be further optimized without migrating away from RDF.
== Useful pages ==
* [[Baloo/Architecture | Architecture]]
* [[Baloo/Configuration]]
* [[Baloo/Debugging]]
* [[Baloo/NepomukPort]]
* [[Baloo/Tasks]]
* [[Baloo/XapianAlternatives]]
* [[Baloo/XapianProblems]]


RDF also heavily relied on ontologies. These ontologies are a way to describe how the data should be stored and represented. They used the ontologies from the original EU research project - Shared Desktop Ontologies. These ontologies were not designed in a time when it was not very clear how they would work and have sub-optimal performance and ease of use. They are quite vague in certain areas and often duplicate information. This leads to scenarios where it takes forever to figure out how the data should be stored. Additionally, since all the data needs to be stored in RDF, one cannot optimize for one specific data type.
== Using Baloo ==


Given these shortcomings and the many lessons learned over the last years the Nepomuk developers decided to drop RDF and rechristen the project under the name of Baloo.
Baloo is not an application, but a daemon to index files.  Applications can use the Baloo framework to provide file search results.


= Migrating from Nepomuk to Baloo =
An [http://vhanda.in/blog/2014/04/desktop-search-configuration/ intentionally limited number of settings] are provided via the KDE System Settings "Desktop Search" icon. Other adjustments can be made directly to the [[Baloo/Configuration | configuration file]].
 
Nepomuk was used to store the tags, ratings, and user comments in Files. This data can be migrated by running the <tt>nepomukbaloomigrator</tt>. Nepomuk was also used to store indexed information about Files, Emails and Contacts. Baloo shall reindex this information directly from the source.
 
= Running Nepomuk and Baloo together =
 
Nepomuk and Baloo can both coexist without issues. However, it may not be the best idea to run both of them on the same system as they both would then be indexing your files, emails and other data and taxing the system heavily, populating their databases.
 
Tags, ratings and comments will be not be synchronized between Nepomuk and Baloo after the initial migration.
 
Applications relying on Nepomuk will have to migrate to Baloo. Their progress can be tracked over here - http://community.kde.org/Baloo/NepomukPort
 
= Baloo, Nepomuk, KDE4 and KF5 =
 
The Nepomuk project will not be ported to Qt5 and KF5. The Baloo project will be ported to KF5. This ported version of Baloo will continue to use the same database as the KDE4 version and will be completely compatible.
 
= Porting your Application =
 
Baloo is not a drop in replacement for Nepomuk. The majority of Nepomuk applications just rely on tags, ratings and comments. Baloo offers a simple asynchronous API for modifying that file metadata. This metadata is now stored with the extended attributes of the file instead of storing it in a separate database.
 
Baloo also offers a search API which is similar to that of Nepomuk in some ways.

Revision as of 17:08, 19 August 2017

Help Konqi find what he wants!

Baloo is the file indexing and file search framework for KDE Plasma.

Mailing List: [email protected] (info page)
IRC Channel: #kde-baloo on freenode

Baloo focuses on providing a very small memory footprint along with with extremely fast searching.

Useful pages

Using Baloo

Baloo is not an application, but a daemon to index files. Applications can use the Baloo framework to provide file search results.

An intentionally limited number of settings are provided via the KDE System Settings "Desktop Search" icon. Other adjustments can be made directly to the configuration file.