ExcalidrawZ README

README проекта с github.com/chocoford/ExcalidrawZ. Одним файлом markdown: README.md.

ExcalidrawZ logo

A native Excalidraw client for macOS, iPadOS, and iOS. Powered by SwiftUI.

GitHub Twitter Discord

Donation to Chocoford

Excalidraw is an excellent drawing tool. ExcalidrawZ keeps the familiar Excalidraw canvas, then adds native file management, iCloud sync, history, export, AI assistance, MCP integration, and Apple-platform interaction details around it.

Download

Download Link - App Store

Non-App Store version

  1. Download the latest .dmg from Releases.
  2. Open the .dmg and drag ExcalidrawZ into Applications.

Preview

App overview

Features

Native File Management

ExcalidrawZ manages drawings as real app documents instead of loose browser downloads.

File History

ExcalidrawZ records checkpoints for app-managed drawings, so you can review earlier versions and restore important work when needed.

File History

Excalidraw Editing, Native Controls

The canvas remains compatible with Excalidraw while the surrounding app is built for Apple platforms.

Collaboration

Use Excalidraw collaboration when you want to draw with others.

Collaboration

AI Drawing Assistant

ExcalidrawZ includes an AI assistant designed for canvas work.

ai_chat

MCP Services

ExcalidrawZ can expose the current app as an MCP server for compatible AI clients.

MCP

Math and Diagram Tools

ExcalidrawZ includes richer tools for technical drawings and study notes.

Math&Diagram

Locked Files and AI Visibility

For sensitive drawings, ExcalidrawZ adds protection around both storage and AI access.

file_lock

Share, Export, and Backup

ExcalidrawZ supports common export and sharing workflows.

Export editable image

Supported Formats

ExcalidrawZ can open, import, edit, or export common Excalidraw-related formats:

Contact

Welcome to my Discord server to share suggestions or report issues for ExcalidrawZ.

Development Guide

Signing configuration

Create Config/Overrides.xcconfig relative to the repository root, alongside Config/Project.xcconfig:

DEVELOPMENT_TEAM = YOUR_TEAM_ID
ICLOUD_CONTAINER = iCloud.com.yourname.ExcalidrawZ
APP_GROUP_IDENTIFIER = group.com.yourname.ExcalidrawZ

Replace these example values with identifiers registered to your Apple Developer team. The shared configuration leaves DEVELOPMENT_TEAM empty; set your team in the local overrides. The app and QuickLook extension must use the same App Group. All targets, including the extension and tests, inherit the team from Config/Project.xcconfig, which includes your local overrides. These overrides apply to all build configurations.

Runtime configuration

Create Config/Secrets.plist relative to the repository root. The project already references this file and includes it in both app targets' resources. The app's configuration loader stops with Unable to load Secrets.plist if the file is missing or invalid.

For local drawing development, this minimal configuration is sufficient:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>COLLAB_URL</key>
    <string>https://example.com</string>
</dict>
</plist>

COLLAB_URL must be a valid absolute URL. The example URL is a placeholder for local drawing work; to test collaboration, replace it with the URL of your deployed collaboration-enabled Excalidraw web client.

Optional string keys are ONEDRIVE_CLIENT_ID, GOOGLE_DRIVE_MACOS_CLIENT_ID, and GOOGLE_DRIVE_IOS_CLIENT_ID. Configure your own OAuth client IDs when developing the corresponding integrations.

Config/Overrides.xcconfig and Config/Secrets.plist are ignored by Git and should stay local.

ExcalidrawZ (chocoford/ExcalidrawZ)

Ищем в базе…

Что это такое?Нативный клиент Excalidraw для macOS, iPadOS и iOS, написанный на SwiftUI. Он сохраняет привычное полотно Excalidraw и добавляет нативное управление файлами, синхронизацию через iCloud, историю файлов, экспорт и помощь ИИ.
Это веб-приложение или настольная программа?Это нативное приложение, а не веб-страница. Полотно остаётся совместимым с Excalidraw, а оболочка вокруг него создана для устройств Apple.
Как установить его на Mac?Скачайте последний .dmg со страницы Releases, откройте его и перетащите ExcalidrawZ в Applications. Это версия не из App Store.
Работает ли совместная работа из коробки?При сборке из исходного кода по умолчанию — нет. Пример COLLABURL — это заглушка, поэтому для реальной совместной работы нужен URL вашего развёрнутого веб-клиента Excalidraw с поддержкой совместной работы.
Работает ли оно на Windows или Linux?Нет. Приложение создано только для платформ Apple: macOS, iPadOS и iOS.
Куда попадают мои рисунки и может ли ИИ их видеть?Рисунки — это файлы, которыми управляет приложение; они могут синхронизироваться через iCloud между вашими устройствами Apple. Заблокированные файлы скрыты от ИИ, а для каждого файла вы можете решить, виден ли он ИИ.
Чем это отличается от простого использования Excalidraw в браузере?Рисунки работают как настоящие документы приложения: с группами, пользовательской сортировкой, синхронизацией через iCloud и контрольными точками истории, а не как разрозненные загрузки из браузера. Само полотно остаётся совместимым с Excalidraw.
Какие форматы файлов оно может открывать и экспортировать?Оно открывает, импортирует, редактирует и экспортирует файлы .excalidraw, .excalidraw.png и .excalidraw.svg. Также поддерживаются импорт и экспорт PDF и экспорт изображений.
Могут ли ИИ-инструменты подключаться к нему?Да. Приложение может работать как MCP-сервер через локальную HTTP-конечную точку. Базовый режим даёт рабочий процесс рисования excalidraw-mcp, а оптимизированный режим добавляет более глубокую интеграцию с ExcalidrawZ.
Как защищены конфиденциальные рисунки?Файлы можно заблокировать локальной аутентификацией, зашифровать вместе с их контрольными точками и использовать Recovery Key для резервного доступа.
Какие есть похожие проекты?ipadn, zulu, sill, OpenYoink, Crest, excalidraw, opendisplay, MacPacker
Автор
chocoford
Размер
130.3 MB
Звёзды
2K
Возраст
3 г
Коммиты · 90 дней