# Windows
git clone https://github.com/MasouShizuka/projects.yazi.git %AppData%\yazi\config\plugins\projects.yazi

# Linux/macOS
git clone https://github.com/MasouShizuka/projects.yazi.git ~/.config/yazi/plugins/projects.yazi

Configuration

Add this to your keymap.toml:

[[mgr.prepend_keymap]]
on = [ "P", "s" ]
run = "plugin projects save"
desc = "Save current project"

[[mgr.prepend_keymap]]
on = [ "P", "l" ]
run = "plugin projects load"
desc = "Load project"

[[mgr.prepend_keymap]]
on = [ "P", "P" ]
run = "plugin projects load_last"
desc = "Load last project"

[[mgr.prepend_keymap]]
on = [ "P", "d" ]
run = "plugin projects delete"
desc = "Delete project"

[[mgr.prepend_keymap]]
on = [ "P", "D" ]
run = "plugin projects delete_all"
desc = "Delete all projects"

[[mgr.prepend_keymap]]
on = [ "P", "m" ]
run = "plugin projects 'merge current'"
desc = "Merge current tab to other projects"

[[mgr.prepend_keymap]]
on = [ "P", "M" ]
run = "plugin projects 'merge all'"
desc = "Merge current project to other projects"

If you want to save the last project when exiting, map the default quit key to:

[[mgr.prepend_keymap]]
on = [ "q" ]
run = "plugin projects quit"
desc = "Save last project and exit the process"

Don't forget to add the plugin's setup function in Yazi's init.lua, i.e. ~/.config/yazi/init.lua. The following are the default configurations:

require("projects"):setup({
    save = {
        method = "yazi", -- yazi | lua
        yazi_load_event = "projects-load", -- event name when loading projects in `yazi` method
        lua_save_path = "", -- saved file path in `lua` method, comment out or assign explicitly
                            -- default value:
                            -- windows: "%APPDATA%/yazi/state/projects.json"
                            -- unix: "~/.local/state/yazi/projects.json"
    },
    last = {
        update_after_save = true,
        update_after_load = true,
        load_after_start = false,
    },
    merge = {
        event = "projects-merge",
        quit_after_merge = false,
    },
    event = {
        save = {
            enable = true,
            name = "project-saved",
        },
        load = {
            enable = true,
            name = "project-loaded",
        },
        delete = {
            enable = true,
            name = "project-deleted",
        },
        delete_all = {
            enable = true,
            name = "project-deleted-all",
        },
        merge = {
            enable = true,
            name = "project-merged",
        },
    },
    notify = {
        enable = true,
        title = "Projects",
        timeout = 3,
        level = "info",
    },
})

Note

Settings that are not set will use the default value.

`save`

Note

Yazi's api sometimes doesn't work on Windows, which is why the lua method is proposed

method: the method of saving projects:

yazi: using yazi api to save to .dds file
lua: using lua api to save

lua_save_path: the path of saved file with lua api, the defalut is

Windows: %APPDATA%/yazi/state/projects.json
Unix: ~/.local/state/yazi/projects.json

`last`

The last project is loaded by load_last command.

update_after_save: the saved project will be saved to last project.

update_after_load: the loaded project will be saved to last project.

load_after_start: the last project will be loaded after starting.

Only work with lua method, please refer to #2

`merge`

event: the name of event used by merge feature.

quit_after_merge: the merged project will be exited after merging.

`event`

The corresponding event will be sent when the corresponding function is executed.

For specific usage, please refer to #5 and #12.

`notify`

When enabled, notifications are displayed when actions are performed.

title, timeout, level are the same as ya.notify.