Skip to main content

Dakkar

Dakkar is a Python GNOME file browser with grid, list and expandable-list views, windows, tabs, panes, and optional position and colour ranking visualisations.

Setup

sudo apt install            \
    desktop-file-utils      \
    gir1.2-gtk-4.0          \
    gir1.2-gdkpixbuf-2.0    \
    gir1.2-gnomedesktop-4.0 \
    python3-docopt          \
    python3-gi              \
    python3-setuptools      \
    python3-venv            \
    python3-wheel

Optional: Tracker accelerates indexed filename searches. File Roller provides archive creation, extraction and encrypted archives and passcode prompts. GStreamer metadata bindings add audio and video properties.

sudo apt install                \
    file-roller                 \
    gir1.2-gstreamer-1.0        \
    gir1.2-gst-plugins-base-1.0 \
    gir1.2-tracker-3.0

From a source checkout, perform a user installation.

./install.sh --user

Alternatively, perform a system-wide installation.

sudo ./install.sh --system

Dependencies are checked, a virtual environment with access to GNOME bindings is created, and the programme is installed without downloading packages. Launcher, desktop entry and icon are also installed. This method is recommended because pip does not place desktop integration files at the appropriate user or system locations.

PyPI setup

The programme can be installed from PyPI. A virtual environment with access to system site packages is required so that PyGObject and GNOME bindings remain visible.

python3 -m venv --system-site-packages .venv
source .venv/bin/activate
pip install dakkar
dakkar --version

This method does not install the desktop entry or application icon, and the distribution packages listed above are still required.

Configuration

High-contrast borders are enabled by default (--high-contrast) and can be disabled (--no-high-contrast). A dark palette with blue selection colour is used by default; the GTK theme and colours can be inherited with --system-theme. Colour ranking is disabled by default and can be enabled with --directory-tint. Optional indexed filename search can be disabled with --no-index.

Usage

Cause Effect
Ctrl+F Search filenames below the displayed directory
Ctrl+Shift+F Search filenames below Home
Printable character input Search filenames using the selected scope
Escape during search Clear the search and return to the directory view
Ctrl+L Focus the editable location field
Alt+Left / Alt+Right Navigate back or forward
Back / Forward keys Navigate back or forward
Mouse buttons 8 / 9 Navigate back or forward
Middle mouse button Open a directory or place in a new tab, or open a file
Drag / Ctrl+drag Move items to the destination / copy them instead
Alt+Up / Alt+Home Open the parent directory or Home
Ctrl+1 / Ctrl+2 / Ctrl+3 Use list, grid or expandable list view
Ctrl+H Show or hide hidden files
Ctrl+T / Ctrl+W Open or close a tab
Ctrl+Shift+T Restore the most recently closed tab
F9 Show or hide Places
Ctrl+N Open another window
Ctrl+Shift+N Create a directory
F2 Rename the selected item
Ctrl+C, Ctrl+X, Ctrl+V Copy, cut and paste
Ctrl+D Duplicate selected items
Ctrl+Z / Ctrl+Shift+Z Undo or redo a safe session operation
Delete / Shift+Delete Move to Trash or permanently delete
Alt+Return Show properties
Ctrl+. Open the displayed local directory in a terminal
F5 or Ctrl+R Refresh
F1 Show keyboard shortcuts

Behaviour

Places, paths and tabs

GTK bookmark files are read from the GTK 4 and GTK 3 configuration directories. A place can be opened in a new tab with the middle mouse button. The place context menu provides Open in new tab and Open in new pane when available, Open in new window and Open in terminal. The button beside the Places heading hides the panel; F9 and Show or hide Places restore the previous panel width. Each breadcrumb path button provides the same directory actions.

Two tabbed panes can be displayed side by side. Open in new pane creates a second notebook at the right and transfers focus without moving existing tabs. New tabs and window-level navigation target the focused pane. Closing the final pane tab collapses the split. Tab labels use end ellipsisation when space is insufficient, and hovering reveals the full directory name. A tab context menu provides Duplicate tab, Open in new pane when available, Open in new window, Open in terminal, Copy location, Refresh and Close tab for the targeted tab.

Ctrl+Shift+T restores tabs in most-recently-closed order, including navigation history, pane and tab position, view, ordering, hidden-file state, grid settings, filters and colour-ranking configuration.

Search and views

Search is restricted to filenames. Printable character input at the directory view is forwarded to Search filenames, providing type-ahead search without interfering with editable controls. The first sorted match is selected automatically when results begin to appear; later asynchronous batches do not overwrite a subsequent selection. Escape clears the query and returns focus to the directory view. Filters restricts loaded items and search matches by MIME family and modified, accessed or created date. Changes are staged until Apply is selected; selecting elsewhere closes the panel without applying them. Filters are retained by each tab. Searches can be saved and reopened through Saved. Direct global search is restricted to the home directory when the system index service is unavailable.

Expandable list view presents native disclosure controls beside directories. Expanding a row loads its immediate children asynchronously, and nested directories may be expanded to arbitrary depth. Several branches can load concurrently and each branch is monitored for external changes. Sorting, filters, selection status, context menus, drag-and-drop and file operations apply to nested rows. Expanded URIs are restored across refreshes and filter changes. Search results remain a flat list until the query is cleared.

Directory loading presents a small initial batch before processing larger batches, while sorting is distributed across GTK main-loop turns. File-monitor and completed-operation updates add, replace or remove only affected items in root and expanded views. Manual refresh preserves the displayed model while a background snapshot is reconciled. Up to ten recently visited directory snapshots are retained by each tab so that Back, Forward and repeat navigation can present cached contents immediately. Thumbnail requests belong to visible cells, prioritise newly visible items, discard obsolete callbacks after scrolling or navigation, and use a bounded in-memory cache.

Newly-opened directories start at the top of each view. The first item is maintained as the scrolling anchor during asynchronous enumeration and layout. Returning directly to a parent with Back selects and scrolls to the directory which has just been left after the parent has loaded.

File operations

Selected files can be dragged between directories or exchanged with applications supporting the GTK file-list transfer type. Dropping over a directory targets that directory; dropping over the view background targets the displayed location. Move is preferred, while holding Ctrl requests Copy. Drag operations use the same recursive merge and conflict handling as clipboard operations.

Paste, drag-and-drop, Copy to… and Move to… share recursive conflict handling. Same-named directories may be merged or skipped. A merge descends into both trees and asks separately about nested conflicts. File conflicts show source and destination sizes and modification times and provide Cancel, Replace, Skip and a selectable destination name. Decisions may be applied to subsequent applicable conflicts. A skipped file remains at the destination during a copy and at the source during a move. Duplicate creates names such as file (copy).

The directory-view context menu is adapted to its target and selection. Directory-only actions are omitted for files. Copy name copies each selected stored filename or directory name, while Copy path copies each complete native path, or the URI of a non-local item; multiple values are separated by line breaks. Open groups selected files by their default application and launches each application once with its complete group. Open with… lists applications advertised for every selected content type and passes the complete selection in one launch. A middle click opens a directory in a focused new tab or performs the normal Open action for a file. Filename-search results also provide Open item location variants which reveal the original result at its parent directory.

A local executable file provides Run as program…. The safety dialogue offers Run in background or Run in terminal. Both modes use the executable parent directory as the working directory. The terminal is launched with the desktop startup-notification context and originating input timestamp so that focus can be transferred without minimising.

The main and background menus provide New directory… and New file…; the editable defaults are directory and file. A newly created directory is selected after the refreshed view has loaded it. Open in terminal targets a selected directory or the displayed directory when requested from the view background. Paste is shown in context menus only when the clipboard contains files.

Archive actions are provided by the item context menu. The selected format is conveyed to File Roller by the filename suffix, and File Roller handles password dialogues for encrypted archives.

Undo and redo are session-only and safely reverse rename, creation of an empty directory, and creation of an empty file. Copy, move, drag-and-drop transfer, duplication, Trash, permanent deletion and externally handled archive operations install an undo barrier. Requesting Undo after one of those operations displays a dialogue explaining that it cannot be undone safely. Older history is discarded so that an inverse is not applied out of chronological order.

Metadata and status

Mounted volumes are shown in Places with eject and unmount controls. Filesystem type, capacity and free space are reported asynchronously by the status line when supplied by the location.

When items are selected, the status line immediately reports their count and the known size of selected files. If directories remain selected briefly, recursive logical size is calculated by a cancellable background worker and progress is reported until the combined total is available. The delay avoids starting a traversal on the first click of a double-click. Unselected directories are not inspected by the selection-size worker, symbolic links are not followed, and changed selection cancels superseded work. Unreadable directory contents are identified beside the partial total.

Direct directory item counts are calculated away from the GTK thread and shown in all three views without collecting recursive sizes or modification times. Their calculation is deferred briefly after a directory has been enumerated and is restricted to directory items which have become visible, so that unseen directories do not compete with the initial view. Results are delivered to the interface in bounded batches without replacing model items. Recursive inspection starts promptly only while Size or Deep directory modification is selected for sorting, or while an enabled colour-ranking channel requests either measure. Inspection is cancelled when no active selection requires it. Collected metadata is reused when order is reversed or the requested recursive measure changes, including for loaded expandable branches.

Metadata

Release files for dakkar 2026.11.8.50

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dakkar 2026.11.8.50
File Size Uploaded Provenance Actions
dakkar-2026.11.8.50.tar.gz 85.3 kB Without provenance Details for dakkar-2026.11.8.50.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dakkar 2026.11.8.50
File Interpreter ABI Platform Actions
dakkar-2026.11.8.50-py3-none-any.whl Python 3 none any Details for dakkar-2026.11.8.50-py3-none-any.whl

Total release size: 168.2 kB

Release files / dakkar-2026.11.8.50.tar.gz

Download URL dakkar-2026.11.8.50.tar.gz
Size 85.3 kB
Tags Source
SHA-256 checksum
How to use checksums
074ef661f42811d6bc42467227f4696df2bc2536b7631b4273dedfbefd527951
BLAKE2b-256 checksum
How to use checksums
529c82ba170dd74cf565228aff8d599b16c1d8fc05da441512e86e7fb52d505e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / dakkar-2026.11.8.50-py3-none-any.whl

Download URL dakkar-2026.11.8.50-py3-none-any.whl
Size 82.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
add1df57063ed52ba0401d3517dc866bd453039b08f3eced220e834ef14d1574
BLAKE2b-256 checksum
How to use checksums
5d0a6219ccace0138f7d2d13df6812c5109c88fd7e20fc537c5f224a946635cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for dakkar 2026.11.8.50

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page