{"id":49317234,"url":"https://github.com/artfacility/fleshnote","last_synced_at":"2026-04-26T16:01:00.041Z","repository":{"id":340964157,"uuid":"1168372546","full_name":"ArtFacility/FleshNote","owner":"ArtFacility","description":"Write first, note second. Minimalist writing app for excessive worldbuilders and planners who actually want to finish their book","archived":false,"fork":false,"pushed_at":"2026-04-26T14:09:44.000Z","size":10142,"stargazers_count":50,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-26T15:08:06.743Z","etag":null,"topics":["note-taking","worldbuilder","writing-tool"],"latest_commit_sha":null,"homepage":"https://artfacility.xyz/fleshnote","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArtFacility.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-27T10:06:26.000Z","updated_at":"2026-04-26T13:21:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ArtFacility/FleshNote","commit_stats":null,"previous_names":["artfacility/fleshnote"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ArtFacility/FleshNote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtFacility%2FFleshNote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtFacility%2FFleshNote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtFacility%2FFleshNote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtFacility%2FFleshNote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArtFacility","download_url":"https://codeload.github.com/ArtFacility/FleshNote/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArtFacility%2FFleshNote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32303177,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["note-taking","worldbuilder","writing-tool"],"created_at":"2026-04-26T16:00:51.912Z","updated_at":"2026-04-26T16:01:00.030Z","avatar_url":"https://github.com/ArtFacility.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FleshNote IDE (v1.1.0 Beta)\n\nAn advanced, no-bullshit writing tool for novelists and world builders who actually want to finish their draft this century. Built with Electron, React, TypeScript, and FastAPI.\n\n[![License: MPL 2.0](https://img.shields.io/badge/License-MPL_2.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)\n\n![FleshNote IDE](assets/full_ide.png)\n\n## Why FleshNote?\n\nFleshNote was built by writers, for writers. I created this app mainly for myself to help me write my novel, but I decided to make it open source so that other writers can benefit from it as well.\n\n### 🧹 The Janitor (Your Smart Editing Assistant)\nWrite now, edit later. The built-in Janitor actively reads your chapters in the background using local, offline linguistic analysis (spaCy \u0026 NLTK) to offer structural suggestions without ever interrupting your flow:\n- **Sensory Analysis**: Avoid \"White Room Syndrome.\" The Janitor tracks if your scene is missing descriptions of Smell, Taste, Touch, Sound, or Sight.\n- **Show, Don't Tell**: Detects weak adverbs and passive voice.\n- **Readability \u0026 Pacing**: Grades your chapter complexity and warns you if you start three sentences in a row with the exact same word.\n\n![Sensory Analysis](assets/sensory_analysis.png)\n\n### 🏃‍♂️ Hardcore Sprint Modes\nSometimes you just need a little push to get drafted. FleshNote gamifies the writing process with specialized, un-exitable Focus Modes:\n- **Hemingway Mode**: The backspace and delete keys are completely disabled. No inner-editor allowed. You can only move forward!\n- **Zen Mode**: Relax and watch a procedural tree grow on your screen as you hit your word count goals. Hitting your target makes the tree bloom.\n- **Kamikaze Mode**: Stop typing for too long, and your text turns red before being permanently deleted. Survive the sprint!\n- **Fog Mode**: Previous sentences fade into a thick fog, keeping your eyes locked on the *current* sentence so you don't scroll up.\n\n![Zen Mode Timelapse](assets/zen_mode_timelapse.gif)\n\n### 🧠 Epistemic UI (Who Knows What?)\nTrack exactly what a character knows at any given point in your timeline. Use the **Entity Inspector** to lock away a character's \"True Goal\" while they lie to the reader, visually tracking narrative deception across chapters.\n\n![Knowledge State](assets/knowledge_state.png)\n\n### 🗺️ Timeline \u0026 Plot Planner\nA zoomable, multi-layer canvas for mapping out your story beats, arcs, and foreshadowing natively injected straight into the manuscript. \n\n![Plot Planner](assets/plot_planner.png)\n\n### 📜 World History Timeline\nTrack what happened with your characters and items before the book even begins. Build a deep chronological history by dragging relationships and pinning major backstory events across an interactive, visual timeline.\n\n![History Timeline](assets/history_timeline.gif)\n\n### 📂 Unified Entity \u0026 Twist Tracking\nDumping lore into your project is easy. Managing it is easier. The codebase features a robust tabbed dashboard to manage Characters, Locations, Twists, and Quick Notes with bulk operations and inline tagging (`@mention` any character right in the editor).\n\n![Entity Manager](assets/entity_manager.png)\n\n### 📚 Professional Book Export\nExport straight to industry-standard formatting. Generates print-ready PDFs, standard DOCX files, and EPUBs with a WYSIWYG  live preview.\n\n![File Export](assets/file_export.png)\n\n### Other Features\n\n- **Chapter Time Overrides**: Track flashbacks and timeskips at the paragraph level so your entities and relationship dynamics remain chronologically accurate.\n- **Environment \u0026 Weather System**: Define weather states per location with **Hierarchical Inheritance** (sub-locations automatically pull weather from parents).\n- **7 Total Sprint Modes**: Let it be Rewarding or Punishing, there is a mode for every writer.\n- **Daily Writing Encouragement**: Context-aware prompts and streak tracking when you open your project.\n- **Sketchboards \u0026 Mind-Mapping**: Visual node-graph canvas for mapping out magic systems, technology trees, and character webs.\n- **Smart Entity Renaming Wizard**: Safely rename characters or locations across your entire manuscript with automated text-link rewriting.\n- **Custom World Calendars**: Build your own calendar systems with custom months, seasons, and years for precise age and history tracking.\n- **Image Gallery**: Each entity type has its own gallery and Icon. Add description, time, and crop icons.\n\n---\n\n# Getting Started\n\n\u003e ⚠️ **Windows Users:** I'm a solo indie dev and I don't plan on buying an expensive Windows Code Signing Certificate. When installing the app, Windows SmartScreen will show a scary blue pop-up warning you about an \"unrecognized app\". Simply click **More info** -\u003e **Run anyway** to proceed with the installation!\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (Project uses npm)\n- [Python 3.13](https://www.python.org/) (For backend services)\n\n### Installation\n\n1. Clone the repository and navigate into the `fleshnote-ide` subfolder:\n   ```bash\n   cd fleshnote-ide\n   ```\n2. Install the frontend dependencies:\n   ```bash\n   npm install\n   ```\n3. Setup the Python backend environment:\n   ```bash\n   cd backend\n   python3 -m venv .venv\n   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n   pip install -r requirements.txt\n   cd ..\n   ```\n   \u003e **Note:** `requirements.txt` contains only runtime dependencies. If you plan to **build/package** the app with PyInstaller, use `requirements_build.txt` instead.\n\n### Development\nRun the application in development mode:\n```bash\nnpm run dev\n```\n\n## 📦 Building for Production\n\nYou can build the production installer using the provided platform-specific scripts or npm commands. \n\n**IMPORTANT**: When building the app manually (via npm), you *must* also manually freeze the Python backend using PyInstaller first. The provided build scripts (`build.bat` and `build.sh`) handle this dual-compilation step for you automatically!\n\n### Using Build Scripts (Recommended)\n\n**Windows** (PowerShell/CMD):\n```bash\n./build.bat\n```\n\n**Linux/macOS** (Terminal):\n```bash\nchmod +x build.sh\n./build.sh linux  # or ./build.sh mac\n```\n\n### Manual Build Commands\n\n*(Remember to run PyInstaller on the backend first!)*\n\n**Windows**\n```bash\nnpm run build:win\n```\n\n**macOS**\n```bash\nnpm run build:mac\n```\n\n**Linux**\n```bash\nnpm run build:linux\n```\n\n**Linux (Flatpak)**\n\n\u003e **Note:** To build Flatpak correctly, you must ensure `flatpak` and `flatpak-builder` are installed on your system. \n\u003e Since the bundler operates at the user-level, you also **must** have the Flathub remote added for your local user environment, or the build will fail:\n\u003e ```bash\n\u003e flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo\n\u003e ```\n\n```bash\nnpm run build:flatpak\n```\n\n## 🛠️ Recommended Setup\n\n- **IDE**: [VSCode](https://code.visualstudio.com/)\n- **Extensions**: \n    - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)\n    - [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)\n    - [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)\n\n## 📄 License\n\nThis project is licensed under the **Mozilla Public License 2.0**. See the [LICENSE](LICENSE) file for the full text.\n\n---\nBuilt with ❤️ by [Artfacility](https://www.artfacility.xyz)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartfacility%2Ffleshnote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartfacility%2Ffleshnote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartfacility%2Ffleshnote/lists"}