Introducing NEO

Nine years ago, I wrote a blog post about my ideal novel writing tool called NEO. You can read that original post here. The problem I was trying to solve was replicating the clean, crisp workflow I’ve always had in Apple’s Pages, before Apple updated and ruined Pages. Most of my novels have been written in the black, distraction-free full-screen mode Pages creates that you can swipe to and forget about the rest of your laptop. Just your words, a wordcount at the bottom, and an interface that gets out of the way.

Yes, there are thousands of writing tools out there, and the problem with them usually falls into one of two camps: They are made to do everything, so they don’t do anything cleanly, like Word. Or they try to be too clever and give you every book-writing gadget in the universe, like Scrivener. People swear by both. I begrudgingly use them.

Whatever perfect writing tool you’re about to mention in the comments, I’ve probably already tried. I’m so glad it works for you! Keep writing! Stay awesome! None of them work for me. I don’t want to spend any time in my word processor doing ANYTHING but writing. Nothing to break the creative flow state. Just my words. Basic key strokes to do basic things.

Writing a novel in Word or Pages means inserting page breaks, numbering a chapter, centering that number, centering section breaks, uncentering to start writing again, renumbering every chapter because you inserted a new one, ad naseum. NEO was going to be designed from the ground up to do one thing: write long-form prose. That’s it.

The last time I worked on this application, it was with a software developer while I was sailing across the Pacific. Limited internet access made the collaboration difficult, and we never got past basic functionality. It wasn’t good enough for my daily use, so I never shared it with you all. Today, that changes.

NEO can be downloaded here (.dmg for Mac, .exe for Windows)

It’s still rough, not even beta-worthy, but NEO is now the first thing I boot up in the morning. It’s where my writing is happening. And I’m in love with it. But there’s a lot to work on, so it’ll keep changing. If anyone wants to use it, it’s free! If you find bugs or have suggestions, leave a comment on this blog post below (or at GitHub). I’ll take your thoughts into consideration, but I’m not interested in feature creep or bloat. Just simple and functional. If you want to take the source code and run with it, have a great time!

Installing:

Mac users: double-click the .dmg, drag NEO into Applications, then run it. To make your life a little easier, I actually paid for a Mac Developer license and figured out certifications and signing and all that jazz, so you should only get a warning about running software from the internet. None of that “unidentified developer” nonsense. C’mon, you’re on my blog, you know me.
PC users: double-click the installer. You might get a warning and be asked to continue. I’m not going through the Windows developer nonsense because it’s way crazier and you still get warnings anyway. I haven’t tested this version much, so use at your own risk.

A beginners guide for the brave: The first time you open NEO, it’ll ask you for your name and if you are a pantser or a plotter. All that means is whether new documents open in the Outline tab or the Manuscript tab. You can change this option later at any time (go to File > Goals Settings).

The main interface in Neo is your Shelf. You can have lots of WIPs here, and you can create new shelves to keep them organized. Rename shelves by clicking the name.

Create a new WIP in any shelf or import an existing document. Importing will probably require a little fiddling, as this is not the main goal of NEO. It’s more for starting new projects and seeing them to completion.

A few features to highlight:

This is about distraction-free writing with only the things you need at your fingertips. Complex functions are handled with quick key-presses. Need to start a new section in your current chapter? Hit the enter key twice. Need to start a new chapter? Hit the enter key three times. This and your imagination are all you really need to write a novel in Neo. That’s pretty much it.

Chapters are auto-numbered for you, even if you insert one in an earlier place. Hover your mouse on the left side and you’ll see an outline of all your chapters. Feel free to make a brief note here about what happens in that chapter. On the right side you’ll see Placeholders, a feature I’ve always wanted. To create a placeholder, hit COMMAND + SHIFT + X. Make a note about what you need to do here later and keep plowing forward. All your placeholders are hidden away for when you need them. You can lock this window open by clicking the little symbol at the top, for when you are in afternoon-revising-mode.

If you want to get rid of a piece of writing but don’t want to lose it forever, highlight it and drag it down to the DARLINGS tab. Or hit COMMAND + SHIFT +D. It’ll stay there while you improve the draft. If you realize your original stab was better, you can restore darlings from the darlings tab (or you can delete them forever). This allows you to take creative risks without FOMO. You could also use this to make notes in your draft about things that need to happen in the story, and they’ll stay in Darlings pointing back to the correct place. Great for making notes without needing a second document open (my old, clunky way of writing a novel).

There’s an OUTLINE tab at the bottom for people who prefer to structure their documents ahead of time or brainstorm. If you selected PLOTTER during install, you will begin new books in the Outline tab. For PANTSERS it’s always available with a click. Type a note for each chapter and hit ENTER to create a new chapter in the outline. TAB if you want to create sections within chapters. This will create those chapters and sections in your manuscript for you, with the notes there to be replaced with your lovely prose. Outlining might still be a bit clunky, since I’m more of a pantser myself.

I love to write in fullscreen mode. Just hit COMMAND + SHIFT + F to switch to fullscreen. The same combo or ESCAPE will leave it. Even better, when you want to avoid distractions and the easy swipe over to email or social media, ENTER THE SILO. COMMAND + SHIFT + S will seal you in the vault with your WIP. Leaving is more difficult. Staying is easy. So stay and keep writing!

At the bottom of the writing UI you’ll see how many words you’ve written today. Click this to change your personal daily goal and the goal you have in mind for that WIP. You can also do a sprint from here, with a lightning bolt at the bottom letting you know to keep going and a congrats when you hit your goal. I love this feature.

Back on the SHELF, set a word goal for each project, and a yellow bar will move across the bottom as you near completion. It’s a nod to NaNoWriMo, where a lot of my books were written. You’ll see daily bar graphs and other stats over time. This needs a lot more testing. Let me know if you find a major bug.

If you don’t like the color gradient on your book covers, click the little refresh button in the top right corner of the book cover. The colors are just to help your books stand out from each other. Under the FORMAT option at the top bar, you can change the body font and select one of 3 drop-cap fonts. The idea here is that a book should look like a book while you are writing it. You should be as immersed as the reader!

In the FORMAT drop-down, you can also turn TYPEWRITER mode on and off. This just makes it so your cursor stays in the center of the screen, no need to scroll up and down or follow along with your eyes. I like this sometimes but not all the times, so I made it a feature you can turn on and off with a quick COMMAND + SHIFT + T.

You can export your files in several basic formats. But here’s one of my favorite features! For years, I’ve had a habit of emailing my WIPs to myself to back them up. I often do this after a bit of writing flow where great stuff pours out from the ether and I’m terrified I’ll never be able to replicate it. If you hit COMMAND + E, you’ll email yourself a copy of the current WIP in PDF format. Even better, it’ll create a SHA-256 fingerprint for the file, which proves that the file has not been altered or edited. As you write, a series of these will prove beyond a shadow of a doubt that this is a work you’ve been writing over time. That’s not the primary reason for the feature, but might as well while you’re creating a backup and sending it to yourself. The first time you email a WIP it’ll ask you to choose Apple email or Gmail (PC users will be spared the question).

Spellcheck is default off! No red squiggles to evaporate your creative juices. If you want to turn it on, COMMAND + ; (semi-colon). There’s also a find/replace option, because I can’t live without that. And that’s pretty much it. Poke around to discover more. There’s a shortcuts list under the HELP menu.

The main thing is this: I made this for myself, and I don’t expect anyone else to use it, but there might be another author out there who has had the same frustrations as me, or has a similar workflow and is looking for exactly this. If that’s you, I’m glad we found each other. To everyone: stay awesome and keep writing.

Download installation files here from GitHub

Source code here for nerds


74 responses to “Introducing NEO”

  1. I’ve been waiting for this ever since he posted that blog post years ago! Glad to see it’s finally released.

    I released a very similar app years ago, but I was intrigued to see what you come up with.

  2. Will absolutely give this a go. Never been happy with my options out there. Usually end up writing in Editpad as it’s simple and clean.

  3. I’ll give it a shot. For years my go-to has been Ulysses, esp. for the Markdown editor (before that it was Bean.) The “export” function has a fairly steep learning curve, but once you grok it, it’s very powerful (plus there are tons of free templates.) Also does auto cloud sync and versioning.

    1. Ulysses is decent. I used Bean back in 2023. Tiring.

    2. Musk/Evil/Grok

  4. Windows version: After going through the “run anyway” stuff, it says “shortcut missing” because it can’t find “neo.exe”. I did a search of my entire drive and couldn’t find it myself. I did find and installer.exe and and uninstaller (in AppData). Tried running that installer.exe but about halfway through got an error “NEO cannot be closed”. “Retry” gives same error. “Cancel” gives error saying in can’t uninstall the old version (?).

    1. Yeah, same here. It looks like the shortcut itself is broken. It’s unable to find a NEO.exe physical application and is just the shortcut.

      1. One thing I can think of is Windows Defender might be eating the program, which is why the shortcut points at nothing. I’ve got all that safety stuff turned off on my PC. The code is unsigned, so Windows is going to think it’s full of viruses. Look in your threat history and see if you can restore Neo.exe from there. If so, you can add the folder to exclusions.

        1. Thanks for the tip, but it doesn’t appear to be the issue. I added the folder to exclusions and looked at my protection history to see nothing was affected. I got a fresh link and restarted after adding the exclusion and now the installer says it cannot install while NEO is running, yet NEO has not been installed in the first place and has no processes or details running in the task manager. The installer is still not in the folder for the new download either. Thank you for your help, this tool is a really cool idea as it can be very demotivating to write through Word these days.

          1. I added a standalone version of the app, no setup, just NEO 0.2.1.exe. See if that works.

          2. Thank you, but it seems the standalone is having issues as well. I allowed it through all my protections and yet when I try and open it, it does not load up. I ran it as an administrator and it asked if I wanted to allow the application to make changes to my device as it should, but upon saying, “yes” it just never opened. I checked the error reports on my PC and it shows that the application is not having any kind of error in the loading process. I also tried running it through the Command Prompt and it didn’t load or give me a report on why. My PC seems to recognize it as loading for a second since it prompts me to allow it, but does not show up as running in my task manager or in general.

          3. Yeah, I tried this too but to no avail. Still broken. Running on Windows 11 Pro.

    2. Okay, let me see what I can do. I only ran the 0.1.0 version on an old PC laptop I have on the boat. I don’t have a good Windows testing platform. Thanks for reporting this!

      1. I’m getting the same error and haven’t been able to find a workaround yet either. Please let us PC Peasants know if you discover a way past it! I’d love to use this

  5. As always, Hugh, you’re very generous in sharing with writers your journey and process. Thank you!

  6. Patrice Fitzgerald Avatar
    Patrice Fitzgerald

    Amazing! And very cool.

    Thanks.

  7. I’m a software developer, not a writer. I know that this means: “Email a timestamped PDF snapshot to yourself with a SHA-256 fingerprint of the text in the body” but I don’t know why you’d want the SHA-256 fingerprint. I guess for versioning? That’s the only thing I can think of.

    1. Just trying to think of ways to verify that a timestamp of the draft is legit, because eventually you’d be able to have an AI agent create a history of drafts with fake dates and versions to look like a paper trail. You could probably start with an AI-written book now and tell an agent to create a series of older drafts, complete with typos, etc, to make it look handwritten over time. Short of blockchain solutions (which I know nothing about), what else can you think of to show human provenance for a written work? Maybe the emails alone are enough? It’s not really a big deal or important to my own workflow, just thinking about problems to come for writers in general and possible solutions.

      1. I see where you’re going, makes sense. The only thing I can think of is private key/public key cryptography. Which is probably similar to (or the same) as what you’re doing. If only you know (or have) the secret that created the encrypted file, and it’s difficult to crack, then yeah, it should protect you from AI theft.

  8. Okay, why don’t you distribute through the App Store? I am working on a ‘self-publisher dashboard’ app. Along with my other iOS and Droid apps.

    What is your software license?

    I like this!

    1. Just guessing, but probably because it’s an alpha/beta build and he would have to sign up to be a developer, pay Apple $100 per year, be subject to their guidelines and approvals. Or he can just say “here’s the file – install it”. A lot of the best work out there is open source and available for free on GitHub.

    2. Github is the default for free open-source projects. Publishing on App Store would mean to adhere with all the guidelines, getting dependent on the company and also pay publishing fees.

      Btw, this is how we would install programms for a long time, just download the setup directly from the internet without any tie-ins with a company app shop. Its perfectly fine (if you trust the source)

  9. Will this work on a Linux system?

    1. I hate to put words in Hugh’s mouth, and he can correct me, but I looked at the code and it looks like a local web app. So with a little leg work you could run it on Linux in Firefox or whatever browser you use.

      1. I created a Linux version and just uploaded that. For x86 chips only for now.

        1. Thank you!

  10. Carter McKnight Avatar

    Sounds like Neo is working for you. My writing platform is OpenOffice Writer, using a pre-formatted template I’ve created, complete with title page, dedication, and other assorted front matter, as well as title, author, and page number at the top of each page, plus drop caps and other niceties. I write IN the template. After “THE END” I import the hyphenless file into Jooma for the Kindle version, and then the print version receives hyphenation and kerning before uploading to KDP. Writing in the template makes formatting minimal. Can Neo match OpenOffice for this kind of convenience?

    1. Sounds like you’ve got a great pipeline! I haven’t fine-tuned it yet, but hoping to export directly to .epub from NEO. If I get it working right, I’ll add .mobi conversion as well, even though most places that need .mobi accept .epub.

  11. I haven’t been able to write fiction in years for just this reason. I’m gonna give it a go and hope I can finally get a few of the stories that have been steeping in my brain over the years out!

    1. Nothing would make me happier! Finish something, get it polished, and send it to me to read.

  12. Thanks for sharing this. I’ve been using Ulysses for the reasons mentioned in earlier posts.

    A couple of things:
    – Is it possible to have a san serif font? Just one or two.
    – And a wierd one. I am in New Zealand, but the date stamp for the installed file uses Pacific Time, not local time. An observation!

  13. Just an observation. Word actually works very well if people use it properly. And use Google when Word does not work properly. I’ve been using Word for decades, which has allowed for learning, or stumbling across by accident, how to ameliorate the current challenge (aka bend it to my will), albeit sometimes only temporarily until the next […….] annoyance. OK, maybe I’m not selling it convincingly, but my relationship with Word (and Microsoft’s infuriating social engineering strategy) has always been adversarial. I’m therefore not inclined to sing its praises much.

    However, based on your list of challenges, there is functionality that covers that stuff…but, as I said, it has to be used properly. Otherwise…. [….] Just sayin’.

    1. Please explain me how I can use Word as a distraction-free word processor where I dont have to take care about any formatting and side numbers. Because I use Word also for years and if you don’t need any of the expanded features, you are definitely better of with a more simple word processor.

      Thats like using a high-end gaming PC for webbrowsing.

  14. Thanks for making this but it’s not going to work for me. I’m so accustomed to being able to jump around my chapters with the sidebar in Scrivner, and then to the notes for each chapter on the opposite sidebar. I think it’s going to be great for pansters but plotters are going to miss quickly navigating their project. I’m keeping it installed and might use it to retype my entire manuscript into when I’m done with the rough draft. (I heard there’s some benefit to typing the whole book from scratch???)

    1. never used scrivner, but istn this exact functionality here in NEON? You have your chapter overview in left sidebard and notes in right sidebar.

  15. I haven’t even tried this out yet but look forward to it, and wanted to thank you in advance. Just spent 2 years writing a novel in Google Docs, pecking away on my phone. I shipped it off to the beta readers today. Then found this post.

    Two years in GDocs. Sigh. This Neo thing probably would have been a better way to go. Well, if the beta readers like it now I’ll be better equipped to write a sequel!

    Kudos for considering how writers will need to defend themselves re: AI. Feels like the field is already tilting in a … weird direction.

  16. Thank you! Thank you! I’ve already made the switch to Neo. I’ve published two non-fiction books that were begrudgingly typed up in Pages and Word — the horror!

    Loving that the environment is so distraction-free. Love even more the division of spaces into manuscript, notes, outline, and darlings — genius.

    Right now my only suggestion would be to have some control over the size of the UI font. My aging eyes need a slightly larger size. Other than that, I’m using it for my first foray into fiction, a collection of short stories.

    Thanks, Hugh.

  17. Such a great guide. The step-by-step approach makes it easy to follow along.

  18. Thanks for putting this together. The tips here are practical and well-explained.

  19. Love this! Exactly what I needed to read today. Keep up the great work.

  20. Fantastic resource here. I will definitely be coming back to this again.

  21. First I wanna say that finding this felt a bite like fate, like destiny, like magic. I don’t know, but what are the odds of finding a post from four days ago on my Tumblr dashboard at two am four seconds after I told myself: that’s enough go to sleep.

    I’m so glad I didn’t go to sleep because I think it’s the first time doomscrolling actually gave me something of value, something truly precious.

    I installed NEO, and the interface is so beautiful and clean I almost cried. I’ve been playing with it for only some minutes, but I’m in love. Silo Mode is a genius idea, and I was cackling at the witty messages I had to type. I’m not sure, though, whether it was a problem on my ending but the vault didn’t open, no matter how many times I tried, and the only way I could escape it was by turning off my MacBook. That scared me a bit, but not enough to make me not want to use it.

    NEO seriously has the potential to become the BEST writing tool I ever used, and I say this as someone who already used most of them, Notion, Paper, Pages, Scrivener, BYOK Studio, Pinery, StimuWrite, Ellipsus, Obsidian, you name it I probably have used it. I hope you keep on improving on it, and thank you for sharing it for free.

    I’m glad we found each other too. <3

    1. Glad you’re enjoying it!

      1. Hi, after almost a week of using NEO, and close to 10k words and a lot of tinkering, I have a little more in-depth insights.

        **Things I love:**
        – The interface, it’s clean, beautiful, doesn’t overwhelm me, and I could spend the entire day looking at it.
        – Setting both daily and project goals, especially the yellow bar that appears on project covers and let me have a visual reminder of how much I still have to go.
        – Sprint, and showing how many minutes it took to write that amount of words is a nice touch.
        – Darlings, I had one single document titled *my dear dead darlings*, which involved a lot of copy and pasting and moving between files. No more.
        – How easy it is to create text breaks.
        – Rearranging chapters just by dragging it.
        – Notes & Comments, I was never much into the idea of just use a bracket or TK or whatever for information I could research and add later, mostly because I didn’t trust myself to catch all of them. NEO changed that.
        – Deleted chapters going straight to darlings for easy recover.
        – Night mode, because I’m a vampire.
        – Turning off spellcheck entirely, goodbye red squiggly lines under completely normal names that are not recognized, you’re not missed.
        – Outline, I write like it’s night and I’m blindfolded, but I liked being able to write a little summary under each chapter.
        – That I can alternate between total manuscript and chapter word count with just a click.
        (Basically everything. lol)

        Things I find interesting, but forget to use:
        – Send to email, I set it up, but keep forgetting to send the file at the end of the day because I’m still used to automatic saving and sync.
        – Typewriter scrolling, helpful for not getting lost while editing, but usually when I remember about it I already finished.

        **Things I miss:**
        – Option to turn off Drop Cap Style. Personal preference, probably. But I sometimes write City name, time of the day on the beginning of chapters and it keeps messing with the layout.
        – Headers, or even just an option to centralize the text for quotes.
        – Option to create separations in between chapters for books that have Part I, Part II. I can do that with a chapter, but it doesn’t look very pretty.
        – Being able to move a shelf up and down, change its position like I can with the projects.

        Little bugs I noticed:
        – Sometimes it duplicates the first letter of the following word when I erase something in the middle of a sentence, but I’m not sure what causes it.
        – Silo still doesn’t open the hatch when I type the sentence, even after uninstalling and installing again, though it exits full screen mode so I’m locked but can still quit the program without having to turn off my laptop.

        I still love NEO very, very much.

  22. I will definitely give NEO a shot. Sadly, I’m a Plantser. I plot, then pants, then plot, then pants. But this makes Placeholders, Darlings and Outline pretty intriguing to me. Currently, I’m just pasting this stuff in Google docs: placeholders in comments, darlings at the bottom of the manuscript, my evolving outline below that. Plus character studies, theme and symbolism reminders, dialog ideas, etc. So whenever it comes time to “restructure, review or rewrite”, I end up scrolling, opening up multiple tabs, scribbling stuff down on paper. Workarounds that eject me from the flow and send me straight to the coffee machine. So, yeah color me excited.

    As a broader observation, I think NEO is a vanguard entry in a new era of personalized software. As has been your experience, until now, an expert who wanted to put an idea into software form had no choice other than to hire a developer. I’ve seen many such projects die on the vine because: independent programmers are rare people; still too expensive for most pet projects; and unlikely to stick around for the inevitable revision and maintenance that is necessary to make software successful.

    But all this changes with AI. Granted, coding with AI is still a human skill, but it’s one that can be mastered in weeks rather than the years that were necessary to achieve competence with manual coding. And AI is fantastic at maintenance, so the time horizon for personalized software is no longer just the few months until inspiration or financial wherewithal (<— I'd need the spell checker for that word) wear thin.

    Coffee first. Then NEO.

  23. Ah, it’s an Electron app. I’ve coded quite a bit of Electron over the years and so went ahead and cloned the project and gave it a test drive. I really like that the tech aesthetic matches the app philosophy itself. Lean and clean. Overall, the app reminds me of Vellum: highly opinionated and eschewing bloat.

    I did find one serious bug. At one point, while playing with stickies, I hit cmd-z and basically lost the manuscript and all the stickies. I’m honestly not sure how it happened. I tried repeating what I did and couldn’t replicate. So I guess, just know that it’s out there!

    One usability issue is that the manuscript page doesn’t hold its position when you switch to a different view (e.g. outline, notes) and back. Your cursor resets at the very top. Probably an easy fix.

    Bold and italic are hidden features. Claude explained to me how to get to them with key commands. I guess a smarter person would have learned these basic key commands a long time ago. GUIs have made me lazy.

    The way the outline interacts with the manifest is dodgy. I see the makings of a good concept here, the way “sections” appear as guides on the manuscript. But the way three asterisks appear seems oddly broken. It’s also disorienting that the chapter text doesn’t transfer the same way that section text does.

    On the technical side, I like the decision to use `contentEditable`. It arguably offers enough functionality to satisfy most writing requirements. Underline and strikethrough are missing but could be added easily in the existing keystroke listener. Subscript/superscript and small caps might be more challenging, maybe possible with some CSS and clever use of embedded divs. Claude would find a way . . .

    My last book made heavy use of text messages and I’m actively wondering how I would have done this in NEO. In Google docs I used fixed font with single and double indentation while Vellum supports text messages as a native capability. I’ve not used lists in my writing but this could be another gotcha for some writers. Ultimately, it may not matter if things like smallcaps, texts and lists are supported though since it is all get worked out during typesetting anyway. A writer who likes NEO’s environment is likely to put up with some inconvenience.

    I really, really like typewriter mode. It does make cut & paste a 3 click operation rather than a 2 click operation but I think a determined user would quickly adapt to this.

    The sticky interface is promising but needs work. The yellow question mark in its current form is distracting. I think some creative CSS to make it look like a footnote marker would be an improvement. Displaying the sticky contents in a mouseover would be nice but admittedly feature bloat. The current focus mechanism is workable but warrants some sort of highlighting CSS because it’s easy to get lost in a sea of stickies. It is annoying that the sticky list is ordered by entry time rather than by position in the manifest. I like that the stickies persist until you resolve them instead of disappearing when you delete their containing text. But maybe this is what creates the ambiguity that prevents ordering them by manuscript position.

    The intended interplay (if any) between the notes tab and sticky comments is unclear to me. I guess the main thing I want to do with my general notes is to organize them by chapter. Some notes might apply to Chapter 1. Some notes apply to all chapters (for instance symbolism).

    — for emdash is brilliant (I know the keystroke on Mac but can never remember on Windows). Nice touch that … is caught too (though stylistically I always prefer . . . anyway). Of course, this prevents an end user from *actually* typing multiple hyphens, thus begging the Word convention that — reverts back to actual hyphens. (Damned devilish details.)

    Darlings is good. Claude found the keyboard shortcut for me because D&D with my touchpad is always hit or miss, no strike against the software though.

    Personally, I don’t typically go in for goals, stats and gamification (when it comes to writing, I always underperform) but I do think it’s a great feature: “Tonal for writers”. Now you just need to embed inspirational videos to keep writers motivated :)

    Overall, it’s promising. In this state I would probably use it for short stories but would be nervous about committing long form content until I got more comfortable with it. Exporting (and maybe auto-saving) to markdown is probably worth considering as it would allow for easier transfer between other editors. epub would be the bomb.

    1. Great feedback! I’ll see what I can do with the next version.

  24. I was just researching this exact topic and found your insights on NEO fascinating. The focus on a distraction-free writing environment is crucial for many writers today. It’s exciting to see how tools like this can enhance creativity and productivity. For those looking for additional writing resources, I recommend checking out 7best.in. What features do you think are essential in a modern writing tool?

  25. Love the idea of a writing device that deliberately removes distractions instead of adding more features. There’s something appealing about separating the actual writing from everything that comes afterward. Pairing that kind of focused drafting with a clean Markdown workflow for organizing material later could make for a wonderfully simple setup.

  26. I really like the intuitive features of this. I have a question, though: Can I import an existing document with italics and bold intact? I’ve got an 80k novel but Neo is stripping all the formatting out when I import it.

  27. What a great tool and gift (thank you so much). After watching the video I downloaded the Linux (LMDE 7 Daily Driver), X86 and Arm versions and the Mac Apple Silicon Version. I instantly got NEO running on my LMDE 7 Computer, M1 Macbook Air and M4 Mac Mini. Excited about the tool and ease of installation, I took a few minutes and worked through the process of getting up and running on the Chromebook I keep in the car. Again Great Gift and nice tool – Thank You

  28. Absolutely love this. I’m really enjoying it so far. One thing I instinctively tried to do was move to one of the sections along the bottom – the notes, outlines, darlings – using CTRL+left arrow (or right arrow to move back) – or by using CTRL+TAB as in the modern browser to scroll through tabbed pages. This is my own personal preference but it’s another instance where the fingers never leave the keyboard, which is I suppose my measure of comfort when writing. But thank you – I’m always procrastina… I mean, looking for the perfect writing app. This one is great. Thanks for making it, and for sharing it.

  29. I tried to move the folder to my iCloud drive, but when I move and try to open the files I had previously made, it can’t find those files. How do I find those old files, because it just wants me to open the folder and can’t find anything to import.

    1. Did you physically move the folder? Or did you change where the folder is located from inside NEO? If you go to File > Library Folder… that should allow you to change the location of your NEO Library. When you do this, it will keep the old copy where it is so you don’t accidentally lose anything. But if you copied the folder without going through the File menu, then it’s now looking in the old place and not seeing anything.

      Let me know if that helps!

      1. Heya, so the reproduce steps are this (I know Tory, spoke with her about this today)
        – Change the library folder from within the app (where you get the notice that you will have to move your books yourself
        =Once you’ve changed the folder, you no longer have access, which is expected, but
        – one you copy the books folders over they still don’t show in the library. This is unexpected since the wording seems to indicate you can simply move the books somehow.

        I suspect you intended people to export the books first and then import those files rather than copy the books folders?

        I did figure out a manual solution for her btw.

        Manual solution:
        – Edit the catalog file (which retains the human readable name for the book from the previous folder, but marks it as unshelved after the library folder was changed within the app
        – Edit the JSON file to include the unique identifier name of the books that were copied over

        If there is a much simpler way to do this that I am just missing that would be awesome, but the above works for now. I haven’t had a chance to use the app much yet so I am unsure how the backups are supposed to be used, as it would seem simpler to work with them, but honestly changing the text in those places is pretty simple, though perhaps a bit geeky/scary for most

        1. Wait, can you please help me? I think I had the same question but don’t know any of the geeky stuff so I have no idea what I did or how to access my file.

          I was excited by the program and spent a long time formatting my current manuscript so that it would work in NEO, and I put my own cover on it in the library. Then I realized that I’d rather have the NEO Library in a particular folder, so I moved it there. And now I have no idea how to get NEO to open my old file, or to move the old file (which looks like a folder with some .json and .html files in it) to a place where I can get it to open. Hugh, or anyone who understands the setup—could I get some help here?

          1. Ok, so the least technical thing you can do now if you had to, is open the chapters folders, and all your actual text is in there, so I wanted to let you know that first. The text isn’t lost. You should be able to open the html files in any text editor and copy paste from there if you had to.

            I can try and walk you through what I did, which is really just changing one line in two different files, but I’d either have to write out something very detailed or go back and forth a few times with you possibly.

            So to start, if you changed the location by going in the NEO app, and selecting Library folder from the File menu, you can simply change it back to the default folder (it gives you that option once you change the folder from the menu the first time) and all your work will become accessible again unless you moved it. But again, the text isn’t lost, it’s in the different folders, with the manuscript itself being in files in the chapter folders.

            If you get to that step and then want to move the folder again, I think for now you would export it first, then you would be able to import it in the new location, but I would probably wait for Hugh to respond first or if there might be an easier way to simply use the backup files, which I don’t yet know to do myself.

            I hope this helps for now. I might not respond right away, but I will check back when I can

        2. Thank you so much for your generosity. I’ll try to be as specific and thorough as possible.

          What I did was this: I saw that NEO Library lived in my Documents folder. This was actually fine, but I preferred it to be in a subfolder connected to the book I’m writing. I physically moved the NEO Library folder to that folder, chose that folder when I went to Library Folder, and this killed my ability to open my book in NEO.

          After seeing what you did, I tried to do it myself. First, I opened the backup and found my book in a folder called “book-nameofbook-yoomsfndvffd (that’s not what it actually was, but that’s what it looked like). So I went to the library.json file in the NEO Library folder and put the long book name with the string of letters in bookIds: and then I went to the _catalog.txt file. It listed my book title in all caps, had a dash, and there I inserted the long string again (or maybe it was already there, I can’t recall) and changed the “unshelved” property to “Works In Progress.” This spat out a neo-errors.log that said it could not read properties of null (reading ‘writingStyle’). At this point I was supposed to meet people for dinner, so I was both tearing my hair out and trying to make sure I wasn’t making myself late by trying to figure out how to fix where I went wrong. Oh, and then I moved the NEO Library folder back to the Documents folder where it had been and chose “Default” under Library Folder, but obviously that didn’t work either.

  30. Thank you so much for your generosity. I’ll try to be as specific and thorough as possible.

    What I did was this: I saw that NEO Library lived in my Documents folder. This was actually fine, but I preferred it to be in a subfolder connected to the book I’m writing. I physically moved the NEO Library folder to that folder, chose that folder when I went to Library Folder, and this killed my ability to open my book in NEO.

    After seeing what you did, I tried to do it myself. First, I opened the backup and found my book in a folder called “book-nameofbook-yoomsfndvffd (that’s not what it actually was, but that’s what it looked like). So I went to the library.json file in the NEO Library folder and put the long book name with the string of letters in bookIds: and then I went to the _catalog.txt file. It listed my book title in all caps, had a dash, and there I inserted the long string again (or maybe it was already there, I can’t recall) and changed the “unshelved” property to “Works In Progress.” This spat out a neo-errors.log that said it could not read properties of null (reading ‘writingStyle’). At this point I was supposed to meet people for dinner, so I was both tearing my hair out and trying to make sure I wasn’t making myself late by trying to figure out how to fix where I went wrong. Oh, and then I moved the NEO Library folder back to the Documents folder where it had been and chose “Default” under Library Folder, but obviously that didn’t work either.

    1. ANYBODY READING THIS besides the OP: This is us trying to figure out a solution, these are not instructions for what you should do, lol. You’ll probably have a better time exporting anything first and then changing the library folder from WITHIN THE APP. Consider yourself warned.

      Now for Es:

      That’s a lot of things moved around, so let’s delineate some things, just to be through.

      Wherever you have IN THE APP pointed the NEO Library folder, within that folder you should have:

      – _catalog.txt file ( in the main NEO folder)
      – Backups folder (contains zip files, in the main NEO folder)
      – bookDashesUniqueNumbersLetters folder <the folder name will have dashes numbers and letters (Your book is the whole folder. Whether you get it from the backup or the original folder NEO stored your book in you will need that entire folder with the word book and the unique identifying numbers and letters)
      the book folder should contain:
      – book.json file
      – the chapters folder (with the chapters html files inside
      – darlings.json file
      – notes.html file
      – outline.html file
      – stickies. json file

      and also within the main NEO folder you have
      – library.json file

      So retracing your steps make sure you have all those components. The book folder needs all its parts inside, and if you made another book in the new location already it's ok to copy your other backups into the new location also.

      Now as for the error message, I suspect it's something minor.
      Rather than suggest you look at your file or move the location yet again, I'll provide you with my files (anonymized a little) so you can check the format.

      Sample library.json file. This has multiple book files, so note that all but the last entry in the bookIds area have commas at the end of the line. You may have chosen different options than me for the the lower section, but just note the format, making sure quotes are closed, that you have all the braces and whatnot.

      {
      "authorName": "John Smith",
      "penNames": [
      "J Smith"
      ],
      "firstRunDone": true,
      "pageTheme": "night",
      "shelves": [
      {
      "id": "shelf-1",
      "name": "Works in Progress",
      "bookIds": [
      "book-muo9othv-2dgcy",
      "book-muo8xt62-yq9iq",
      "book-mt12f6w4-ytzbo"
      ]
      }
      ],
      "authors": [
      {
      "id": "a1",
      "name": "John Smith"
      }
      ],
      "writingStyle": "pantser",
      "fonts": {
      "body": "Georgia",
      "dropcap": "literary"
      },
      "hintShown": true
      }

      Now here is the Sample Catalog file:

      NEO LIBRARY CATALOG — which folder is which book
      (regenerated automatically; edits here do nothing)

      Angel Story — book-mt12f6w4-ytzbo — shelf: Works in Progress
      IcloudTestManuscript1 — book-muo9ojhv-2dkcy — shelf: Works in Progress
      Untitled — book-muo9othv-2dgcy — shelf: Works in Progress

      I hope that by comparing this you can reconstruct what you need to. Also I noticed there is a reshelve a book option in the file menu, which I wonder if that might have been helpful for us earlier? I'm sorry if I've created more stress for you, I had intended to speak with you first before you tried anything, but I also understand wanting to just try and get things fixed rather than waiting.

      The above was written to try and be thorough and walk through as much in one message without you having to wait any longer, so I hope you understand I don't think you're stupid when I am going through each section about things things that might be obvious, it's just because it will be easier to review everything in detail and thorough troubleshooting rather than go back and forth with hours in between. I'm just figuring things out too, so if anyone see this and has a much easier solution, by all means, please respond I would love to learn.

      Good luck!
      P.S.
      I hope we have not driven Mr. Howey too nuts with this. Thanks for making the app, even if we broke it right away.

      1. Are you kidding? I’m so grateful for the discussion and all your help! AJ, anything I can do for you besides donating to Wikipedia?

        1. Wow, thank you and you’re welcome. I can’t think of anything at the moment. Perhaps one day when I have a completed manuscript, lol, but I feel like that might be a bit much.
          I’m finding myself at a loss for something reasonable to ask for, but I am glad you found it helpful. Guess I’ll have to stick around and keep testing your app!

          1. When you write your book, or rough draft, send it to me and I’ll give it a read. If I can give any editorial help, or an honest blurb, I will.

          2. (D’oh, looks like my reply comment from the email link got put at the end, so that was meant for you Hugh, but I don’t see a direct reply button, so putting this here to acknowledge I saw your reply, thank you)

            Message:
            Well, I’m blinking a lot now, That’s tremendous. Gonna go look for my jaw, somewhere on the floor I think. I am seriously flabbergasted and I will admit inspired by everyone’s generosity. Take care and have a great day!

          3. I think we must be at the max length in the comment chain because I don’t see reply buttons after his message or your latest one. But WOW what an offer! That’s incredible. Count those blessings and get to writing lol

  31. Oh, you are my HERO. I double-checked what I had against what you had and fixed the things I had wrong (some of them were things like an open bracket that never closed; LOL I had the right idea…!) and my book reappeared in the shelf.

    Is there a way I can send you a bit for a coffee or something? I’m really grateful. Email me at esme@hey.com and let me know?

    1. I’m so glad you sorted it out!

      I do love coffee, but I have plenty of it, lol.
      If you would be ok perhaps making a small donation to Wikipdia, the Electronic Frontier Foundation, or perhaps a local literacy, library group in your area, some group that tries to help people have access to information, reading, books, I would consider that splendid.

      1. I’ll donate to Wikipedia! And again—thank you!

  32. Well, I’m blinking a lot now, That’s tremendous. Gonna go look for my jaw now, somewhere on the floor I think.

  33. Haydn Schlinger Avatar

    Hi, this is a great concept! I’ve downloaded it, and it’s so cool! I have a question: is it supposed to be paginated or not? Because when I reach the visible boundary of a page, I expect it to go to the next one automatically; however, it just expands the page to fit the amount of text. I only see physical page breaks when a new section is created.

    1. That’s by design. It will paginate itself when you export it to PDF or EPUB. NEO would only be guessing the page length anyway, depending on font size and how you’ve scaled your UI.

  34. I’m loving it! I wrote my first novel almost exclusively in Google Docs but wanted a no-frills / distraction option that was local. I’ve also tried so many and bloat is, for me, a big dealbreaker.

    I’m particularly loving the default font settings for sci-fi. I’m approx 35K words in (5K of which I’ve written in Neo) on the follow up (trilogy) and I can’t fault the experience. It’s extremely fluid and incredibly generous of you to share this with the world when you could’ve packaged it (and packaged it and before you know it, started selling lunchboxes and t-shirts…)

    Anyhow, this is definitely my go-to now. I’ll also be recommending it to the other novelists in my writer’s group.

    Thank you Hugh!

  35. Hi Hugh,
    Thank you for this! I know it has been satisfying for you to have this tool but for me it is incredible! Whenever I’ve needed just a basic writing tool I open a draft email and use that and if I wanted to go further then google docs etc. This is a great product. Only question is if the drop cap option can be toggled on or off (not a drop cap fan personally). Thanks and you ROCK!

  36. Michael G. Copple Avatar
    Michael G. Copple

    I have to love the simplicity and lack of gadgetry in NEO. The Icon has a great reference to a great set of books and TV series, I am going to guess was meant for humor.

    Silo has really helped me work with the way I think about any form of fiction I am getting ready to produce. A new way to say, “What If?”

Leave a Reply

Your email address will not be published. Required fields are marked *