https://github.com/eugenesvk/marta.ext
Plugins, themes, and keybinds for Marta File Manager
https://github.com/eugenesvk/marta.ext
keybind macos marta plugin productivity theme
Last synced: 10 months ago
JSON representation
Plugins, themes, and keybinds for Marta File Manager
- Host: GitHub
- URL: https://github.com/eugenesvk/marta.ext
- Owner: eugenesvk
- License: mit
- Created: 2022-11-07T07:05:45.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-21T17:32:22.000Z (about 1 year ago)
- Last Synced: 2025-03-21T18:11:09.323Z (11 months ago)
- Topics: keybind, macos, marta, plugin, productivity, theme
- Language: Lua
- Homepage:
- Size: 274 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: ReadMe.md
- Changelog: Changelog.md
- License: License
Awesome Lists containing this project
README
Plugins, themes, and keybinds for
Marta
File Manager for macOS
## Plugins
#### Link
Create 🔗Symbolic Links, ⤻Aliases, or ⤑Hard Links __in the same pane__ or __at the opposite/inactive pane__ with automatically generated names with:
- user-configurable affixes (__Symlink🔗.txt__, __Alias⤻.app__, __Hardlink⤑.md__), single-char by default to delete easier when you move the links elsewhere
- user-configurable affix location (__⎀pre.ext__, __stem⎀.ext__, __post.ext⎀__)
To customize the plugin behavior, paste the following configuration lines to you `behavior { actions {` section and change them; the built-in [config editor](https://marta.sh/docs/configuration/editor/)[^1] contains helpful tips on what each option does and what values it accepts
Click to expand config
```
"es¦file.link.affixSym" "🔗"
"es¦file.link.affixAlias" "⤻"
"es¦file.link.affixHard" "⤑"
"es¦file.link.spot" "stem"
"es¦file.link.maxLinkNo" 1
"es¦file.link.maxIterNo" 0
"es¦file.link.binAlias" "/usr/local/bin/alisma"
"es¦file.link.binHard" "/usr/local/opt/coreutils/libexec/gnubin/ln"
```
['Link' plugin file](https://github.com/eugenesvk/Marta.ext/blob/main/Plugins/es¦file_link.lua)
#### Tab deduplication
Close all duplicate tabs (except for the currently active one):
- semi-automatically: by remapping ⌘W (`"Cmd+W" "es¦tab.✗tab_n_dupe"`) to
+ ✗close the current tab
+ select 1 tab to the ←left (fixing [this issue](https://github.com/marta-file-manager/marta-issues/issues/967))
+ ✗close all dupe tabs
- manually: by running the `Tab: ✗Close Duplicates` action[^2]
['Tab deduplication' plugin file](https://github.com/eugenesvk/Marta.ext/blob/main/Plugins/es¦tab_✗dupe.lua)
## Theme
[Theme file](https://github.com/eugenesvk/Marta.ext/blob/main/Themes/esWhite.theme)
## Keybinds
TBD
## Installation
__Plugins__: copy files from the [Plugins](https://github.com/eugenesvk/Marta.ext/blob/main/Plugins) folder to the same folder in your config folder[^3]
__Theme__: copy files from the [Themes](https://github.com/eugenesvk/Marta.ext/blob/main/Themes) folder to the same folder in your config folder[^3], then
- either run the `Switch Theme` action and select `esWhite`
- or set `theme "esWhite"` in the `behavior {}` section of your `conf.marco` file
__Keybinds__: copy the `keyBindings` section from the [conf.marco](https://github.com/eugenesvk/Marta.ext/blob/main/conf.marco) file to the same file in your config folder[^3]
[^1]: open via `Preferences` action
[^2]: in the [Actions Panel](https://marta.sh/docs/core/actions/#actions-panel)
[^3]: _~/Library/Application Support/org.yanex.marta_ by default, open via `Open Configuration Folder` action
## Known issues
[Link]()
- Due to a lack of Marta alias/hardlink creation APIs (upvote the corresponding issues [alias](https://github.com/marta-file-manager/marta-issues/issues/351), [hardlink](https://github.com/marta-file-manager/marta-issues/issues/981)) you should install [alisma](https://eclecticlight.co/taccy-signet-precize-alifix-utiutility-alisma/) to create aliases (hardlinks are using the system `ln`)
- [alisma 3a (Universal binary for El Capitan to Monterey)](https://eclecticlightdotcom.files.wordpress.com/2022/02/alisma3a.zip) or
- [alisma 2 (Intel-only for El Capitan to Catalina)](https://eclecticlightdotcom.files.wordpress.com/2019/06/alisma2.zip)
- Configuration tips don't display unicode values properly, [see this bug](https://github.com/marta-file-manager/marta-issues/issues/975 )
- After a hardlink is created the file list is not refreshed like it's when a symlink/alias is created, refresh manually to see the new file
- Action names have the default icons even if the user specified custom ones, can't load user config on plugin load (see this [issue](https://github.com/marta-file-manager/marta-issues/issues/983)). Workaround: manually replace the icons in the `marta.action(` lines of your copy of the ['Link' plugin file](https://github.com/eugenesvk/Marta.ext/blob/main/Plugins/es¦file_link.lua)
[Tab deduplication]()
- Closing a tab with a mouse doesn't trigger anything; it also doesn't activate the left tab (see [this issue](https://github.com/marta-file-manager/marta-issues/issues/969))
## Credits
[@yanex](https://github.com/yanex) for creating this highly customizable native macOS file manager;
[@page-down](https://github.com/page-down) for his help with the _Tab deduplication_ plugin