2026-02-10 20:46:54 +02:00
|
|
|
# monkeysucker
|
|
|
|
|
|
2026-02-10 20:57:32 +02:00
|
|
|
This tool converts [WriteMonkey 3](https://github.com/writemonkey/wm3/) sheet files into markdown files.
|
2026-02-10 20:46:54 +02:00
|
|
|
|
|
|
|
|
## Where the database files live
|
|
|
|
|
|
|
|
|
|
WriteMonkey 3 stores its database files in the local application data directory:
|
|
|
|
|
|
|
|
|
|
- Windows: `c:\Users\[user]\AppData\Local\Writemonkey 3\writemonkey3_sheets`
|
|
|
|
|
- macOS: `/Users/[user]/Library/Application Support/Writemonkey 3/writemonkey3_sheets`
|
|
|
|
|
- Linux: `/var/local/Writemonkey 3/writemonkey3_sheets`
|
|
|
|
|
|
|
|
|
|
Additional files in the same folder:
|
|
|
|
|
|
|
|
|
|
- `writemonkey3_sheets_repository` (snippets/repository)
|
|
|
|
|
- `writemonkey3_sheets_history` (history/restore points)
|
|
|
|
|
- `writemonkey3_sheets_projects` (projects)
|
|
|
|
|
- `writemonkey3_custom_dictionary` (plain text)
|
|
|
|
|
|
|
|
|
|
You can also open these folders from within WriteMonkey 3 via its command palette.
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
```
|
2026-02-10 20:55:15 +02:00
|
|
|
python3 monkeysucker.py path/to/datadir path/to/outputdir
|
|
|
|
|
```
|
|
|
|
|
|
2026-02-10 20:46:54 +02:00
|
|
|
## Output rules
|
|
|
|
|
|
|
|
|
|
- One markdown file per document, named `yyyymmdd_sanitized_title.md` (UTC creation date).
|
|
|
|
|
- Only the latest record per document id is exported.
|
|
|
|
|
- YAML frontmatter includes `id`, `title`, `created`, and `modified` (UTC dates). Tags are included only when present.
|
|
|
|
|
- If a document has snippets, a companion file is created with `_snippets` before the extension.
|
|
|
|
|
- Documents are placed into project folders; otherwise they go to the output root.
|
|
|
|
|
- File mtime is set to the document's modified time.
|
|
|
|
|
|
|
|
|
|
## Notes
|
|
|
|
|
|
2026-02-10 20:55:15 +02:00
|
|
|
- The output directory is deleted and recreated on each run.
|
