dequoter/README.md
Leon Mika 9751be125e
All checks were successful
Release Build / build (push) Successful in 1m53s
Moved the plugin directory
2026-09-09 21:08:46 +10:00

58 lines
3.1 KiB
Markdown

# Dequoter
A simple Boop clone for Mac OS. Useful as a scratchpad for performing text manipulation.
**Currently In Alpha:** There are some glaring issues, such as text not being saved between invocations.
This means that **if you restart the app, you will loose your work.** Treat this like an untitled TextEdit window,
where all your chances will be lost when you close it.
## Building
This project uses [Wails](https://wails.io) to build a desktop application with a Go backend and a Vite frontend.
## Plugins
Dequoter can be extended with new filters written in [UCL](https://ucl.lmika.dev).
On startup, Dequoter creates `$HOME/Library/Application Support/dev.lmika.dequoter/plugins` if needed,
then evaluates every file ending in `.ucl` found in it (including subdirectories).
Filters are defined with the `d:filter` builtin:
```
d:filter "String: To Upper Case" { |in|
strs:to-upper $in
}
```
`d:filter` takes a label, which is what appears in the command palette (Cmd+P), and a proc. The proc is
called with the text to process as its only argument. The result of the proc becomes the filter output:
strings are used as-is, other values are converted to their string form, and a proc that returns nothing
is reported as an error. Errors raised with `error` are shown in the status bar.
A plugin filter with the same label as a built-in filter replaces it in the palette. If two plugin files
define the same label, the one loaded later wins (files are loaded in lexical path order). Files that
fail to load are skipped and reported in the status bar; the remaining files are still loaded.
After editing plugin files, choose File → Reload Plugins (Shift+Cmd+R) to rescan the directory without
restarting. This discards the previous plugin filters and UCL interpreter state before loading the files again.
Use File → Open Plugins in Finder or File → Open Plugins in Terminal to access the directory.
If you have plugins in the old `$HOME/.config/dequoter/plugins` directory, move them to the new location.
## Download
[Download Release](/dequoter-darwin-arm64.zip)
## License
Copyright 2026 Leon Mika
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the “Software”), to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.