neo README

The project's README from github.com/hughhowey/neo. As one markdown file: README.md.

NEO

A distraction-free word processor for authors, by a wannabe author.

NEO understands from the moment you install it that you are writing books and nothing else. No bloat, no distractions, with manuscripts that look like books as you write them.

NEO runs locally. WIPs are saved in plain files on your disk. No accounts or subscriptions. And it's free!

Download

Get the latest installer from the Releases page:

Why NEO?

The bookshelf

Your library looks like a bookshelf, not a file list. Labeled shelves you organize however you like — by series, by status, by pen name. Progress bars on the covers show how far you are from your word goals. You can drag-and-drop books anywhere. You can also drag shelves around and put cover art on your titles.

Just a blank page

There's a white page by default or a dark mode (which I now prefer!). Controls fade until you mouse over them. Chapters number and renumber themselves automatically. Drop caps mark chapter openings, because I'm a sucker for drop-caps. Em dashes, true ellipses, and curly quotes sort themselves out as you type. Spellcheck exists only when you invoke it — no more red squiggles mid-sentence triggering your imposter syndrome.

Enter, Enter, Enter

One Enter: new paragraph. Two: a *** section break. Three: a new chapter. The goal is to KEEP WRITING.

Darlings

The writing advice is "kill your darlings" — but I say: keep the bodies. Drag any beautiful-but-in-the-way passage onto the Darlings tab. It leaves your manuscript but isn't lost. Darlings restore to the exact spot it came from. More like zombies than darlings.

Placeholders

Mid-flow and need a name, a fact, a date? ⌘⇧X drops a mark and a sticky note. The left panel shows a red dot on every chapter that you need to get back to. The right panel will list all these to-do items.

Outlining for plotters

Outline chapters and sections in the Outline tab; section notes appear in the manuscript as gray ghost paragraphs, ready to be overwritten. Pantsers can ignore all of it or learn to draw a freakin' map for the first time. Try it. You might like it!

Cover Art

Every book gets a cover! New books are dressed in a seeded abstract (six art styles, six type templates, typefaces bundled with NEO) so no two stories on the shelf look alike. Once a story passes 1,000 words, NEO can read it and paint an abstract cover from the text. This is a bit more work but totally worth it. Get an OpenAI API key from their website and paste it into Goals & Settings. The art is generated in the background for about a penny a picture. (These are not meant for publication, just writing inspiration!) The API key is stored encrypted in NEO's own settings, never in your library folder. The title and author are always set in real type on top, so the lettering is never left to a gen-AI model. The ↻ on any book re-rolls its type and colors, or paints it again. And you can always switch back and forth from the seeded modern look to the painted variety.

Goals and momentum

Daily word goals, word sprints, and a NaNoWriMo-style progress chart. Needs more testing, but I think it works okay!

Exports

EPUB 3 with a proper table of contents built to KDP's guidelines, Word .docx, PDF, HTML, markdown, and plain text. Email a timestamped PDF snapshot to yourself with a SHA-256 fingerprint of the text in the body. Might come in handy someday.

Import

Bring in existing .docx, .txt, and .md manuscripts; chapters and scene breaks are detected automatically. This is still a bit rough and might require you to tweak things. It will try to grab your title and remove that from the body, and it seems to be working okay.

Backups

Continuous autosave, daily zip backups kept for two weeks, everything stored as plain files. Set up your NEO library folder on your iCloud if you want for extra safety. You can also email copies of your WIP to yourself with a keystroke: ⌘E.

Your files

Everything lives in ~/Documents/NEO Library — one folder per book, chapters as readable HTML, metadata as JSON. Open them in your favorite text editor.

Building from source (for the eggheads):

Requires Node.js.

git clone https://github.com/hughhowey/neo.git
cd neo
npm install
npm start

To build installers: npm install electron-builder --save-dev, then npm run package (macOS), npm run package:win (Windows), or npm run package:all. Output lands in dist/.

The app is very simple: an Electron shell (main.js), a preload bridge (preload.js), and a renderer (app.js + styles.css + index.html). If you know JavaScript, you can change NEO. Have at it.

Roadmap (things I'm dreaming up but may never get to):

Chapter version history · manuscript format for agent submissions (Times New Roman, double-spaced, address block, just to make Kristin Nelson happy) · global end matter that updates every book at once (same for copyright pages, bios, etc).

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Fair warning: NEO is opinionated by design, and bloat killed every writing app I've ever tried. If you want complex, try Scrivener. It really is a great application beloved by many! There are so many wonderful writing apps out there! Nobody needs to use this but me.

License

MIT — free to use, free to modify, free to share.

Philosophy

If you didn't know, I opened up the Silo universe to fan fiction years ago. And not just to put on fan fiction sites, but you can charge money for the things you write and keep every penny of the income! Lots of incredible Silo Stories out there. But readers are forever looking for more.

neo (hughhowey/neo)

Searching Database…

1.5K ·GitHub
这是什么?NEO 是一款专为写小说打造的无干扰文字处理器,由小说家 Hugh Howey 开发。它在本地运行,把书稿保存为磁盘上的普通文件,无需账号或订阅。
这是通用文字处理器,还是专为小说家打造的更专业的工具?它是专为小说家打造的桌面应用,而不是通用编辑器:书籍像书架一样组织,章节自动编号,README 本身就把想要更复杂功能的人指向 Scrivener。
只是运行它需要 Node.js 或其他东西吗?不需要——下载并运行安装程序即可。只有当你想用 electron-builder 从源码自己构建安装程序时才需要 Node.js。
导入已有书稿能完美工作吗?导入 .docx、.txt 和 .md 文件并自动检测章节/场景分隔仍有些粗糙,可能需要手动调整。可选的 AI 封面功能也需要你自己的 OpenAI API 密钥,每张图成本约一美分。
我的文稿和 API 密钥实际去了哪里?所有内容都以普通文件形式存储在你自己磁盘的 ~/Documents/NEO Library 中。如果你为封面功能添加 OpenAI 密钥,它会以加密形式存放在 NEO 自己的设置里,绝不会进入你的书库文件夹。
连按多次回车会发生什么?按一次回车开始新段落,按两次创建分节符,按三次开始新章节——这个快捷设计让你无需伸手去点菜单,保持写作状态。
“Darlings”是什么?一个标签页,你可以把任何删掉的段落拖进去而不是直接删除;文字离开书稿,但之后可以恢复到原来的确切位置。
NEO 能为我生成书籍封面吗?可以——每本书默认都会得到一个基于种子的抽象封面;当作品超过 1000 字后,NEO 可以使用你自己的 OpenAI API 密钥根据文本绘制 AI 封面。书名和作者名始终用真实字体排印,绝不是 AI 生成的。
可以导出为哪些格式?带 KDP 兼容目录的 EPUB 3、Word .docx、PDF、HTML、Markdown 和纯文本,你还可以给自己发一封附有时间戳 PDF 快照和 SHA-256 指纹的邮件。
Creator
hughhowey
Size
17.4 MB
Stars
1.5K
Age
2mo
Commits · 90 Days