ReadMe.md

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¹ 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

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)
  • ✗close all dupe tabs
• manually: by running the Tab: ✗Close Duplicates action²

'Tab deduplication' plugin file

Theme

Theme file

Keybinds

TBD

Installation

Plugins: copy files from the Plugins folder to the same folder in your config folder³

Theme: copy files from the Themes folder to the same folder in your config folder³, 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 file to the same file in your config folder³

Known issues

Link

• Due to a lack of Marta alias/hardlink creation APIs (upvote the corresponding issues alias, hardlink) you should install alisma to create aliases (hardlinks are using the system ln)
  • alisma 3a (Universal binary for El Capitan to Monterey) or
  • alisma 2 (Intel-only for El Capitan to Catalina)
• Configuration tips don't display unicode values properly, see this bug
• 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). Workaround: manually replace the icons in the marta.action( lines of your copy of the 'Link' plugin file

Tab deduplication

• Closing a tab with a mouse doesn't trigger anything; it also doesn't activate the left tab (see this issue)

Credits

@yanex for creating this highly customizable native macOS file manager; @page-down for his help with the Tab deduplication plugin

Footnotes

1. open via Preferences action ↩

2. in the Actions Panel ↩

3. ~/Library/Application Support/org.yanex.marta by default, open via Open Configuration Folder action ↩ ↩² ↩³