# monkeysucker

This tool converts WriteMonkey 3 sheet files into markdown files.

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

```
python3 monkeysucker.py path/to/datadir path/to/outputdir
```

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

- The output directory is deleted and recreated on each run.