{"id":35863603,"url":"https://github.com/arto-app/arto","last_synced_at":"2026-04-25T05:04:39.150Z","repository":{"id":318760539,"uuid":"1073576196","full_name":"arto-app/Arto","owner":"arto-app","description":"🅰️ Arto — the Art of Reading Markdown.","archived":false,"fork":false,"pushed_at":"2026-03-20T15:10:50.000Z","size":2355,"stargazers_count":141,"open_issues_count":12,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-21T07:02:36.329Z","etag":null,"topics":["macos","markdown"],"latest_commit_sha":null,"homepage":"https://arto-app.github.io/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arto-app.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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},"funding":{"github":"lambdalisue"}},"created_at":"2025-10-10T10:04:50.000Z","updated_at":"2026-03-20T15:10:24.000Z","dependencies_parsed_at":"2025-10-15T07:06:26.431Z","dependency_job_id":"28c955f8-f276-4a2c-88ac-d54d838041c2","html_url":"https://github.com/arto-app/Arto","commit_stats":null,"previous_names":["lambdalisue/rs-arto","arto-app/arto"],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/arto-app/Arto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arto-app%2FArto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arto-app%2FArto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arto-app%2FArto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arto-app%2FArto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arto-app","download_url":"https://codeload.github.com/arto-app/Arto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arto-app%2FArto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31793225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"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":["macos","markdown"],"created_at":"2026-01-08T13:17:44.803Z","updated_at":"2026-04-14T11:01:01.216Z","avatar_url":"https://github.com/arto-app.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./extras/arto-header-readme.png\" alt=\"Arto\" /\u003e\n\u003c/p\u003e\n\n**Arto — the Art of Reading Markdown.**\n\nA local app that faithfully recreates GitHub-style Markdown rendering for a beautiful reading experience.\n\n## Philosophy\n\nMarkdown has become more than a lightweight markup language — it's the medium for documentation, communication, and thinking in the developer's world. While most tools focus on _writing_ Markdown, **Arto is designed for _reading_ it beautifully**.\n\nThe name \"Arto\" comes from \"Art of Reading\" — reflecting the philosophy that reading Markdown is not just a utility task, but a quiet, deliberate act of understanding and appreciation.\n\nArto faithfully reproduces GitHub's Markdown rendering in a local, offline environment, offering a calm and precise reading experience with thoughtful typography and balanced whitespace.\n\n\u003e [!WARNING]\n\u003e **Beta Software Notice**\n\u003e\n\u003e - This application is still in **beta** and may contain bugs or unstable behavior. Features may change without regard to backward compatibility.\n\u003e - **macOS Only**: This application is currently designed exclusively for macOS and does not support other platforms. However, cross-platform support is a long-term goal, and **PRs are welcome**.\n\n## Features\n\n### Core Reading Experience\n\n- **GitHub-Style Rendering** — Accurate reproduction of GitHub's Markdown styling with full support for extended syntax\n- **Native Performance** — Built with Rust for fast, responsive rendering\n- **Auto-Reload** — Automatically updates when the file changes on disk\n- **Offline First** — No internet connection required — read your docs anytime, anywhere\n\n### Navigation \u0026 Organization\n\n- **File Explorer** — Built-in sidebar with file tree navigation for browsing local directories\n- **Quick Access** — Bookmark frequently used files and directories for instant access\n- **Directory History** — Back/forward navigation within the sidebar file explorer\n- **Table of Contents** — Automatic TOC panel for easy document navigation\n- **Live Navigation** — Navigate between linked markdown documents with history support (back/forward)\n\n### Search \u0026 Discovery\n\n- **Find in Page** — Search within documents with `Cmd+F`\n- **Pinned Search** — Pin search queries with persistent multi-color highlighting across sessions\n\n### Window \u0026 Tab Management\n\n- **Tab Support** — Open and manage multiple documents in tabs within a single window\n- **Multi-Window** — Create multiple windows and open child windows for diagrams\n- **Cross-Window Tabs** — Drag and drop tabs between windows\n- **Drag \u0026 Drop** — Simply drag markdown files onto the window to open them\n\n### Advanced Rendering\n\n- **Mermaid Diagrams** — Interactive diagram viewer with zoom, pan, and copy-as-image\n- **Math Expressions** — Beautiful KaTeX rendering for mathematical notation\n- **Code Highlighting** — Syntax highlighting with copy button for code blocks\n- **Frontmatter** — Renders YAML frontmatter as a styled, collapsible table\n- **GitHub Alerts** — Full support for NOTE, TIP, IMPORTANT, WARNING, and CAUTION alerts\n\n### Customization\n\n- **Dark Mode** — Manual and automatic theme switching based on system preferences\n- **Zoom Controls** — Keyboard shortcuts and trackpad gestures for zoom\n- **Preferences** — Configurable settings for sidebar, TOC, and more\n- **Context Menus** — Right-click menus for quick actions on files and content\n\n## Installation\n\nUse [Homebrew] tap to install. Since the application is not signed or notarized with an Apple Developer ID, you'll need to remove the quarantine attribute after installation.\nSee [homebrew-tap] for more information.\n\n```\nbrew install --cask arto-app/tap/arto\nxattr -dr com.apple.quarantine /Applications/Arto.app\n```\n\nAlternatively, [Nix] is also supported.\nTo try it without a permanent installation:\n\n```\nnix run github:arto-app/Arto\n```\n\nFor a permanent installation, use [nix-darwin] or [home-manager].\nAdd the following to your flake inputs:\n\n```nix\narto.url = \"github:arto-app/Arto\";\n```\n\nThen add it to `environment.systemPackages` (nix-darwin) or `home.packages` (home-manager):\n\n```nix\nenvironment.systemPackages = [ inputs.arto.packages.${system}.default ];\n```\n\nLaunch the application to see the welcome screen with keyboard shortcuts and usage instructions.\n\n## Usage\n\nAfter installation, the `arto` command becomes available in your terminal:\n\n```\narto                     # Launch Arto (shows welcome screen)\narto README.md           # Open a specific file\narto --open=screen README.md\narto --open=new README.md\narto --directory=. README.md\narto docs/               # Open a directory in the file explorer\narto file1.md file2.md   # Open multiple files in tabs\n```\n\nArto runs as a **single instance** — if Arto is already running, the command sends requests to the existing process instead of launching a new one.\n\n- `arto FILE` uses `last_focused` behavior by default (reuse last focused visible window).\n- `--open=screen` opens on/reuses a visible window on the cursor's current screen.\n- `--open=new` always opens in a new window.\n- `--directory=DIR` sets the FileExplorer root directory for that invocation.\n- Positional directory arguments (e.g. `arto docs/`) also set the root directory.\n- Running `arto` without arguments shows/focuses an existing window if hidden, or opens one if none exists.\n\n[Homebrew]: https://brew.sh/\n[homebrew-tap]: https://github.com/arto-app/homebrew-tap\n[Nix]: https://nixos.org/\n[nix-darwin]: https://github.com/nix-darwin/nix-darwin\n[home-manager]: https://github.com/nix-community/home-manager\n\n## Official Website\n\nVisit [arto-app.github.io](https://arto-app.github.io) for screenshots, feature highlights, and more.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.\n\n## License\n\nSee [LICENSE](LICENSE) file for details.\n","funding_links":["https://github.com/sponsors/lambdalisue"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farto-app%2Farto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farto-app%2Farto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farto-app%2Farto/lists"}