Recent Files for DankMaterialShell

A launcher plugin that brings XDG recent files into DankMaterialShell's unified search. Type rf to activate it, or enable Always Active to show recent files alongside apps and other results in the launcher's All tab.

Features

• Searches file names and full paths
• Sorts results by the latest XDG visit or modification timestamp
• Configurable trigger prefix and result limit
• Opens files and directories with their default application
• Watches the XDG recent-files database for changes
• Has no external runtime dependencies

Requirements

• DankMaterialShell 1.5.0 or newer
• Quickshell 0.3.0 or newer
• Applications that write recent items to the XDG recent-files database

The plugin reads $XDG_DATA_HOME/recently-used.xbel, falling back to ~/.local/share/recently-used.xbel. It does not upload or transmit this data.

Installation

Clone the repository into the DMS plugin directory:

git clone https://github.com/gouwazi/dms-recent-files.git \
  ~/.config/DankMaterialShell/plugins/RecentFiles

Then enable Recent Files in DMS Settings > Plugins.

To load it from the command line after DMS discovers the directory:

dms ipc call plugins enable recentFiles

Usage

Open the DMS launcher and type rf followed by an optional search term, such as rf README. With only the prefix, the plugin offers the most recently used files.

The plugin settings let you change the trigger, show results without a trigger, and choose how many matching files are displayed.

Only applications that update the XDG recent-files database contribute entries. The plugin does not infer recent usage from filesystem access times.

License

MIT