The official installer is now ready! You can download the latest version of FoxNotes directly from my Google Drive:
System Requirements (Important)
To guarantee your security and performance, FoxNotes is built with state-of-the-art technology. Because of this, it requires two components installed on your system: Microsoft .NET 9 and Windows App SDK 1.7.
I have designed the installer to be as smart as possible: it will do its best to detect whether you already have these components, and if any are missing, it will attempt to download and install them automatically (it will also notify you on a dedicated page showing which ones you already have).
Troubleshooting (Manual Downloads)
Sometimes network connections fail, or Windows blocks automatic downloads for NSIS installers, which may cause the application to fail to launch. If the installer encounters an error while downloading the requirements, do not worry; you can install them manually from the official Microsoft servers.
Simply choose the version that matches your processor (if you are unsure, almost all modern computers use the x64 version):
1. Microsoft .NET Desktop Runtime 9.0
- Download for Windows x64 (Recommended for most users)
- Download for Windows x86 (32-bit systems)
2. Windows App SDK 1.7
- Download App SDK x64 (Recommended for most users)
- Download App SDK x86 (32-bit systems)
Version History
Important! Version numbers are not incremental. They’re dates/hours in DDMM.HHMM format. The real version number is 1.0
v1.0.0306.1621
Wiki Editor and Editing Experience
- Redesigned the Wiki Editor interface to provide a more comfortable, modern, and consistent editing experience throughout FoxNotes.
- Reorganized the editor toolbar, grouping related actions such as formatting, headings, links, images, tables, save, and cancel operations.
- Added Undo and Redo shortcuts for editing sessions.
- Added support for H1, H2, and H3 headings directly from the toolbar.
- Improved internal link creation through direct selection of existing notes within the active vault.
- Added a visual image picker with thumbnails for browsing and inserting images stored within the vault.
- The image picker now includes name-based search, page navigation, and limited result loading to improve performance in vaults containing large numbers of images.
- Separated the workflows for inserting existing images and importing new images to simplify content creation.
- Improved table insertion through automatic templates adapted to the user’s configured language.
- Expanded editor localization to cover buttons, messages, dialogs, and content insertion elements.
- The editor now automatically respects the language configured in FoxNotes without requiring an application restart.
- Integrated the editor appearance with the FoxNotes theme engine.
- Colors configured in the Appearance section are now correctly reflected in both the editing area and the preview pane.
- Improved visual consistency between the editor, renderer, main interface, and preview components.
- Refined the visual presentation of the editing area to improve identification of scrolling and navigation regions within large documents.
- Improved editor resizing behavior for more consistent adaptation to different window sizes.
- Adjusted synchronization between editing and preview rendering to provide a smoother writing experience.
- Optimized the handling of visual and temporary resources used by the preview system and image picker, reducing unnecessary accumulation during long editing sessions.
- Improved overall editor stability during editing, note navigation, and multimedia resource insertion.
Synchronization, manifests and media management
- Fixed an issue that could accidentally delete images used by encrypted notes during certain save operations and media integration workflows.
- Improved the handling of images associated with encrypted notes to prevent valid vault files from being incorrectly treated as temporary resources.
- Enhanced media protection during encrypted note packaging and update operations, reducing the risk of unintended resource loss.
- Fixed an issue that prevented missing files from being properly restored when they still existed on another device or synchronization provider.
- The synchronization engine can now recover missing files from the available counterpart whenever a valid restoration source exists.
- Improved detection of missing files during synchronization plan generation, preventing situations where certain items could remain permanently out of sync.
- Refined reconciliation logic between local and remote manifests to better distinguish between intentionally deleted files and files that disappeared due to external causes.
- Reduced false conflicts during synchronization when a file had been deleted on one side but still matched the last known content on the other.
- Improved handling of deletion history records to avoid unnecessary conflicts when propagating legitimate deletions.
- Strengthened validation of remote deletion operations to prevent errors caused by outdated entries or temporary inconsistencies between manifests and physical storage.
- Optimized detection and resolution of inconsistent states caused by missing files, partial restorations, or interrupted synchronization operations.
- Improved cleanup and consolidation of internal synchronization states across devices and providers.
- Reviewed media management within vaults in preparation for future improvements related to reference tracking and synchronization optimization.
- Improved overall synchronization stability in scenarios involving accidental file loss, restorations, conflicts, and content recovery.
v1.0.3105.1933
Operational Security and Fault Tolerance
- Improved startup reliability under Windows and MAUI, preventing initialization failures during first launch and when no workspace has been configured.
- Reworked application initialization flow to avoid UI operations being executed before the main window is fully available.
- Added safe handling for situations where the workspace folder is renamed, moved, disconnected, or becomes unavailable while the application is running.
- FoxNotes now automatically cancels pending synchronization tasks and clears transient state when the workspace becomes unavailable, preventing operations against invalid paths.
- Strengthened validation checks before critical operations such as note loading, creation, editing, renaming, deletion, PDF export, password changes, backlink rebuilding, and synchronization.
- The editor now detects workspace loss during editing and prevents accidental saves without closing the editor or discarding currently opened content.
- Improved resilience when working with unavailable folders, preventing silent failures and unexpected behavior caused by invalid file-system paths.
- The preview system now remains operational even when images or other resources cannot be resolved because the workspace is temporarily unavailable.
Home Screen and Empty Workspace Experience
- Added a dedicated workspace home screen that is displayed whenever no note is currently open.
- The home screen provides an overview of the active notebook, note counts, encrypted note counts, synchronization status, and contextual information.
- Home screen appearance now follows the active theme and adapts automatically to user-selected colors.
- Added support for displaying the official FoxNotes mascot artwork instead of a generic fox emoji.
- Added direct access to the Privacy Policy from the home screen.
- External web links are now automatically opened in the system browser rather than inside FoxNotes.
- Improved internal wiki navigation to preserve note creation workflows, unresolved note links, and internal navigation behavior.
Stability and Release Build Improvements
- Fixed initialization timing issues that could occasionally leave the main content area blank in Release builds.
- Improved startup synchronization between the user interface and rendering engine to reduce race conditions.
- Increased reliability of UI refresh operations during application startup.
- Verified correct operation on both x64 and x86 Release builds, including low-performance Windows hardware.
Localization and Language Support
- Expanded translations to cover synchronization workflows, status messages, startup screens, password dialogs, and recently added interface elements.
- Added localization support for the workspace home screen.
- Improved dynamic language switching across synchronization-related views and dialogs.
- Reduced the number of untranslated interface elements appearing when running FoxNotes in English.
Synchronization Providers
- Strengthened the Local Backup provider for real-world usage scenarios involving external drives, NAS devices, removable media, and multi-vault environments.
- Improved validation of backup destinations to prevent invalid, inaccessible, or unsafe configurations.
- Added safeguards against path traversal and invalid file-system operations.
- Improved handling of temporary synchronization files to prevent them from affecting synchronization inventories.
- Reduced the risk of file corruption during interrupted write operations.
- Added automatic cleanup of leftover temporary synchronization files.
- Improved validation to prevent recursive backup configurations involving the active workspace.
- Added write-access testing during backup configuration to detect permissions or storage issues before settings are saved.
- Synchronization now remains pending when a backup destination is temporarily unavailable rather than interrupting normal application usage.
WebDAV, Docker and Cross-Platform Validation
- Completed real-world validation of the WebDAV synchronization provider against multiple independent server implementations.
- Verified compatibility with Microsoft IIS WebDAV, Apache WebDAV, and Nextcloud running on Docker infrastructure.
- Confirmed support for all core synchronization operations required by FoxSync.
- Improved compatibility with servers that implement WebDAV collections and resource handling differently.
- Verified interoperability with standard Nextcloud WebDAV deployments.
- Confirmed successful synchronization across multiple devices using self-hosted WebDAV infrastructure.
- Validated large synchronization workloads through extensive real-world testing without conflicts or data-loss scenarios.
- Confirmed correct operation of manifest-based synchronization, conflict detection, tombstones, renames, and incremental updates across heterogeneous WebDAV backends.
- Consolidated the remote synchronization architecture in preparation for future providers and cloud integrations.
Google Drive Integration and OAuth Security
- Completed functional Google Drive synchronization support using OAuth 2.0.
- Reduced requested Google permissions to the minimum required by the application.
- Adopted a least-privilege access model based exclusively on application-managed files.
- Removed support for requesting broader Google Drive permissions that are unnecessary for FoxNotes operation.
- Simplified the authentication architecture to reduce configuration mistakes and improve security.
- Verified compliance with Google’s non-sensitive permission requirements.
- Confirmed that the Google Drive integration no longer requires sensitive or restricted scope verification.
- Validated interoperability between Google Drive and the existing manifest-based synchronization architecture.
- Prepared the synchronization framework for future cloud-provider integrations using the same decentralized design principles.
Auto-Sync and Synchronization Experience
- Improved handling of temporary synchronization failures caused by connectivity issues, unavailable devices, disconnected storage, or remote-provider outages.
- Synchronization status indicators now better reflect recoverable situations and pending operations.
- Consolidated Local Backup as a practical automatic backup solution powered by the same synchronization engine used by remote providers.
- Identified the need for visible progress indicators during long-running synchronization and provider-configuration operations.
- Planned the introduction of progress and loading dialogs to improve user feedback during network operations.
- Observed that some self-hosted and high-latency environments may require significantly longer initialization times, reinforcing the importance of progress visibility.
User Interface and Theme Engine
- Improved visual integration between the startup screen, synchronization views, note lists, dialogs, and the active theme.
- Enhanced synchronization context visibility by displaying provider information and synchronization status more prominently.
- Increased visual consistency throughout the application interface.
Technical Cleanup and Cross-Platform Readiness
- Reorganized startup logic to improve reliability and reduce risks associated with asynchronous initialization.
- Added additional safeguards against invalid paths, missing folders, and unexpected file-system changes.
- Verified correct operation on low-performance x86 hardware to expose race conditions and startup issues that may not appear on modern systems.
- Completed interoperability testing across Windows, Docker, WSL2, Apache WebDAV, Nextcloud, and mixed deployment environments.
v1.0.2205.1846
Security and Memory Management
- Adjusted
MemoryStreaminitialization withpubliclyVisible: falseto prevent direct exposure of the decrypted buffer viaGetBuffer(), mitigating the risk of API Misuse without breaking compatibility with the renderer. - Replaced
Array.Clear()invocations on passwords withCryptographicOperations.ZeroMemory(), preventing the .NET JIT compiler from optimizing away the erasing of sensitive memory. - Hidden the status bar at the WebView level to prevent internal temporary paths from being exposed.
Wiki Parser, Rendering, and PDF
- Fixed a critical bug where code blocks delimited by triple backticks failed to emit a closing tag, causing subsequent content to overflow to the end of the document.
- Fixed the table system to eliminate ghost cells, improve handling of empty and multiline cells, and maintain a consistent column structure.
- Refactored the PDF Service to utilize the same two-pass table parser, improving structural consistency between the preview layout, the render engine, and the generated PDF document.
- Fixed an identity collision bug within the Table of Contents.
- Repaired the backlinks engine, which had broken following a previous update.
Editor
- Fixed a bug where the H1 button generated
= text =instead of the correct formatting, and where H2 generated the format corresponding to H1. - Added editor toolbar buttons for Underline, Code Blocks, and Inline Code.
- Fixed the visibility of scrollbars within the Wiki editor under Windows by customizing the native handler.
Themes and Visual Customization
- Added color customization options for headers, text, code blocks, and table borders.
- Light/Dark presets now act strictly as previews: they populate the fields instantly without persisting changes until confirmed via the SAVE button.
- Fixed the “Change Directory” button to maintain optimal readability in light mode without affecting the overall application theme.
Localization
- Added complete Spanish and English localization keys for the new table and code configuration sections.
Prior Updates
v1.0.2005.1117
- Removed the default MAUI/Shell window frame; the window now utilizes a custom TitleBar integrated directly into the FoxNotes user interface.
- Implemented native window extension via WinUI, allowing the entire application to render as a single, cohesive visual surface.
- User-configured colors now correctly propagate to the top title bar, Sidebar, and the rest of the window interface.
- Fixed visual inconsistencies between the Sidebar, HeaderBar, and the new extended title bar.
- Adjusted internal paddings and layouts to ensure compatibility with the new visual window structure.
- Fixed an HTML temporary file locking issue caused by WebView2 when reloading dynamically rendered notes.
- Improved the internal write handling of temporary files utilized by the HTML rendering engine.
v1.0.1905.2210
- Fixed an issue in the text editor where selecting text from right to left could cause accidental deselection or erratic behavior.
- Fixed the interpretation of tags dependent on localized keywords (e.g., “Archivo:”), ensuring seamless compatibility across both Spanish and English interfaces.
- Restructured the text editor to eliminate unnecessary context menu options and improve overall editing stability.
- Separated the configuration window into an independent view to improve internal project organization and UI maintainability.
v1.0.0905.2108
- Enhanced the application’s Note Editor by implementing a reactive split-screen live preview.
- Isolated the Encryption Services and the
SecurePasswordHolderlogic away from cryptographic keys and rasterization processes. - Consolidated the preview generation workflow into its own dedicated service.
v1.0.0805.0853
- Implemented a bivalent
.FOXfile structure: functioning either as a unified Container (Notes + Images) embedded with SHA256 hashes, or as a pure Note file. Encrypted images are no longer saved as separate files; instead, they are embedded directly into the container’s JSON payload, fully resolving the tracking issues found in the previous version. - Fixed an issue during PDF document generation where images exceeding ~2MB on disk could trigger an exception in the Base64 encoder feeding the PDF print pipeline.
v1.0.0405.2018
- Implemented text note encryption. Notes created in this version also have their corresponding image assets encrypted; however, a collision may occur if two notes protected by different passwords reference an image sharing an identical filename.
v1.0.0305.1147
- Improved PDF rasterization layouts to guarantee that formatting does not break tables and that images consistently autoscale to fit the viewport width.
- Added full localization support for the English language.
