LinuxCommandLibrary

balooctl

Control Baloo file indexing and searching

TLDR

Display the status of the indexer

$ balooctl status
copy

Enable/Disable the file indexer
$ balooctl [enable|disable]
copy

Clean the index database
$ balooctl purge
copy

Suspend the file indexer
$ balooctl suspend
copy

Resume the file indexer
$ balooctl resume
copy

Display the disk space used by Baloo
$ balooctl indexSize
copy

Check for any unindexed files and index them
$ balooctl check
copy

Display help
$ balooctl --help
copy

SYNOPSIS

balooctl [options] [command]

PARAMETERS

status
    Displays the current status of the Baloo file indexer (enabled or disabled).

enable
    Enables the Baloo file indexer.

disable
    Disables the Baloo file indexer.

file file
    Show Baloo index data for the specified file.

files
    List all files in Baloo index.

folders
    List all indexed folder.

monitor
    Monitor Baloo activity (real-time).

index path
    Force indexing of the provided path.

remove path
    Remove the provided path from index.

reindex
    Rebuild the entire Baloo index. This can take a significant amount of time.

reset
    Reset Baloo indexer to pristine state, removing all configuration and data.

clear
    Clear all data from index.

config list
    List current Baloo configuration.

config set key value
    Set configuration key to the given value.

config unset key
    Unset the given configuration key.

--help
    Displays help information about balooctl.

--version
    Displays the version of balooctl.

DESCRIPTION

The balooctl command is a command-line utility that provides control over Baloo, the KDE Plasma desktop's file indexing and searching service. It allows users to manage the indexer, check its status, enable or disable indexing, and perform other maintenance tasks.
Baloo helps users quickly find files and documents by indexing their contents. It efficiently scans directories and updates its index as files are created, modified, or deleted. This enables fast searching within Plasma's file manager (Dolphin) and other applications.
balooctl provides a convenient way to interact with Baloo without needing to use the graphical settings. Using balooctl, administrators can view the current status, force a re-index, or exclude certain directories from indexing. This tool is essential for troubleshooting, optimizing performance, and customizing Baloo's behavior on KDE Plasma systems.

<B>PERFORMANCE CONSIDERATIONS</B>

Reindexing can be resource-intensive. It's best to perform reindexing when the system is idle to avoid performance issues. Monitoring Baloo's activity with the monitor command can help identify potential bottlenecks.

<B>EXCLUDING DIRECTORIES</B>

To exclude specific directories from indexing, use KDE's system settings or manually edit the Baloo configuration file. This is helpful for directories containing temporary files, caches, or other data that doesn't need to be indexed.

SEE ALSO

dolphin(1), kfind(1)

Copied to clipboard