https://github.com/fairybow/fernanda
Fernanda — a plain-text-first workbench for creative writing
https://github.com/fairybow/fernanda
cpp creative creative-writing desktop linux macos novel-writing offline productivity qt text-editor windows writing-software writing-tool
Last synced: 7 days ago
JSON representation
Fernanda — a plain-text-first workbench for creative writing
- Host: GitHub
- URL: https://github.com/fairybow/fernanda
- Owner: fairybow
- License: gpl-3.0
- Created: 2025-08-28T17:49:20.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-03-27T15:03:09.000Z (29 days ago)
- Last Synced: 2026-03-27T15:59:12.190Z (29 days ago)
- Topics: cpp, creative, creative-writing, desktop, linux, macos, novel-writing, offline, productivity, qt, text-editor, windows, writing-software, writing-tool
- Language: C++
- Homepage: https://github.com/fairybow/Fernanda
- Size: 15 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
A plain-text-first workbench for creative writing
Fernanda is a plain-text-first workbench for creative writing. Work on single files like a notepad or organize whole projects in [Notebooks (`.fnx`)](https://github.com/fairybow/Fernanda/blob/main/Fernanda/docs/Notebooks.md).
> [!NOTE]
> macOS and Linux builds are available but not well-tested. Bug reports are welcome!
## Features
Fernanda offers two workspace types: a **Notepad** for working directly on the OS filesystem and **Notebooks** for organizing whole projects inside a single, portable `.fnx` archive. Both support multiple windows, tabbed editing, and drag-and-drop.
- Distraction-free editor with line numbers, current line highlight, and selection handles (all togglable)
- Key filters for auto-close, smart quotes, and other typing enhancements
- Notebook file management with virtual folders, drag-and-drop tree, import, and a soft-delete trash system
- Editor themes (and user theme support via `~/.fernanda/themes` with hot reload)
- Cascading settings: per-Notebook settings inherit from Notepad defaults
- Word counter with selection-aware counting and adaptive performance (togglable)
- PDF and image viewing
- [Markdown](https://markdownguide.org/) and [Fountain](https://fountain.io) editing/viewing
See [Features.md](https://github.com/fairybow/Fernanda/blob/main/Fernanda/docs/Features.md) for the full list.
## Installation
**First release coming soon.** (Test releases available!)
> [!IMPORTANT]
> You should not trust your writing with any version of this software less than 1.0.0 (not released yet)! Regardless, always make regular backups of your work.
## Usage
Fernanda accepts file paths as arguments. Valid `.fnx` files open in their own Notebook, and everything else opens in Notepad.
Optional flags:
- `--verbose`: enables debug-level logging to file (default is info-level and above)
- `--log-viewer`: opens an in-app log viewer window for the session
Log files are stored in `~/.fernanda/logs/` and pruned automatically.
## Built with
[](https://qt.io/)
[](https://github.com/richgel999/miniz)
(See [Dependencies.md](https://github.com/fairybow/Fernanda/blob/main/Fernanda/docs/Dependencies.md))
## Building
### Requirements
- C++20
- Qt 6.11 (with [extensions](https://github.com/fairybow/Fernanda/blob/main/Fernanda/docs/QtInstallerOptions.md))
- CMake 3.21+
### Windows (Visual Studio)
1. Install the [Qt Visual Studio Tools](https://marketplace.visualstudio.com/items?itemName=TheQtCompany.QtVisualStudioTools2022) extension
2. Clone
3. Open the `Fernanda/` directory in Visual Studio
4. The Qt VS Tools extension will generate a `CMakeUserPresets.json` with your Qt path
5. Build and run
## Contributing
Hey! Read Fernanda's Code! (I'm proud of it.)
Fernanda's [architecture](https://github.com/fairybow/Fernanda/blob/main/Fernanda/docs/Architecture.md) was carefully considered. I've landed on what I think is a simple but flexible interworking of common architectural patterns designed to keep things in their lanes while allowing lateral communication across a given Workspace (Notepad or Notebook).
I try to keep it clean and focused, and most files are only a few hundred lines long.
That said, there will always be something to improve. Take a look around the repository and get to know the code. If something seems off to you or you have something new in mind, take a look at [CONTRIBUTING.md](https://github.com/fairybow/Fernanda/blob/main/CONTRIBUTING.md), open an issue, and we'll discuss a PR.
## License
Fernanda is free software, redistributable and/or modifiable under the terms of the [GPL 3 License](https://github.com/fairybow/Fernanda/blob/main/LICENSE). It's distributed in the hope that it will be useful but without any warranty (even the implied warranty of merchantability or fitness for a particular purpose).
##
I think, in part, I made this because I wanted to put off writing for as long as possible (as writers are wont to do). But I also wanted to make something all my own, something difficult yet rewarding that was way out of my realm of experience. It's taken forever, and it's still not done (it'll never be *done*-done), but it's well on its way now. Thanks for stopping by, and I hope we'll meet again.
> You have to be all kinds of stupid to say *"I can do this."*
– Linus Torvalds