Plugin for Yazi to show recently used files based on the desktop-bookmark-spec (Linux only).
Recently used files are read and written to / from ~/.local/share/recently-used.xbel.
Suports Yazi 26.8.15 or later.
- Shows the recently used files with their
added(btime),modified(mtime), andvisited(atime) time stamps with a VFS. - Adding/Deleting/Updating entries in
recently-used.xbel - Copying of files from the VFS
Requires xmlstarlet to be available.
Installation with Yazi Package Manager
ya pkg add nmetschke/recentsAdd the following to
vfs.toml
[recents."*"]
kind = "hub"
run = "recents"and
yazi.toml
[[plugin.prepend_fetchers]]
group = "mime"
prio = "high"
run = "recents"
url = "recents://*"
[[plugin.prepend_preloaders]]
mime = "recents/**"
run = "recents"
[[plugin.prepend_previewers]]
mime = "recents/**"
run = "recents"
The recently used files can be opened using yazi recents:///@/ or by calling the plugin plugin recents with a keybind.
"sort mtime --reverse=yes", "linemode mtime" can be added to sort by modification time.
keymap.toml
[[mgr.prepend_keymap]]
on = ["g", "r"]
run = ["plugin recents", "sort mtime --reverse=yes", "linemode mtime"]
desc = "Go to recently used"The selected or hovered file(s) can be added to the recents list (or updated) using plugin recents modify.
For example
keymap.toml
[[mgr.prepend_keymap]]
on = ["o"]
run = ["plugin recents modify", "open"]
desc = "Open selected files and add to recently used"will change the default open keybind to also add the file to recently-used.xbel.
Add the input to flake.nix
{
inputs.recentsYazi = {
url = "github:nmetschke/recents.yazi";
inputs.nixpkgs.follows = "nixpkgs";
};
}and configure Yazi
{ pkgs, inputs, ... }:
{
programs.yazi = {
enable = true;
plugins = {
recents = inputs.recentsYazi.packages.${pkgs.stdenv.hostPlatform.system}.default;
};
vfs.recents."*" = {
kind = "hub";
run = "recents";
};
settings.plugin = {
prepend_fetchers = [
{
url = "recents://*";
run = "recents";
prio = "high";
group = "mime";
}
];
prepend_preloaders = [
{
mime = "recents/**";
run = "recents";
}
];
prepend_previewers = [
{
mime = "recents/**";
run = "recents";
}
];
};
keymap = {
mgr.prepend_keymap = [
{
on = [
"g"
"r"
];
run = [
"plugin recents"
"sort mtime --reverse=yes"
"linemode mtime"
];
desc = "Go to recently used";
}
{
on = "o";
run = [
"plugin recents modify"
"open"
];
desc = "Open selected files and add to recently used";
}
];
};
};
}