Документация

Установка

Самый быстрый способ, в любом дистрибутиве:

curl -fsSL https://quickdesk.click/install.sh | bash

Скрипт выбирает .deb, .rpm или AppImage для вашей системы, проверяет SHA-256 и устанавливает пакет (посмотреть скрипт). Или возьмите пакет на странице загрузки и установите скачанный файл так:

• Ubuntu, Debian, Mint, Pop!_OS: sudo apt install ~/Downloads/QuickDesk_<version>_amd64.deb
• Fedora, openSUSE: sudo dnf install ~/Downloads/QuickDesk-<version>-1.x86_64.rpm
• Всё остальное: сделайте AppImage исполняемым и запустите. Нужен FUSE 2 (libfuse2, в Ubuntu 24.04 — libfuse2t64).

QuickDesk нужна система x86_64 последних лет (glibc 2.34 или новее). Лучше всего он работает в GNOME, и в Wayland, и в X11.

Windows 10 и 11 (64 бит): в PowerShell выполните irm https://quickdesk.click/install.ps1 | iex или скачайте установщик со страницы загрузки. Он ставится только для вашего пользователя, без прав администратора. Установщик пока не подписан, поэтому Windows может сообщить, что защитила ваш компьютер: выберите Подробнее → Выполнить в любом случае. В Windows сочетания клавиш — Win Alt N / V / P, QuickDesk живёт в области уведомлений, а автовставка не требует настройки. Вкладка Runtimes там работает через mise, rustup и uv (см. Версии языков).

При первом запуске экран приветствия показывает сочетания клавиш и предлагает две опции: запуск при входе в систему (нужен, чтобы история буфера обмена и кольцо ИИ работали всё время) и мгновенная вставка (см. Автовставка). После этого QuickDesk живёт в верхней панели.

macOS

Ещё в разработке. Версия для Mac работает, но она новая: ещё не всё проверено на каждом Mac, а автовставка и сочетания клавиш продолжают дорабатываться. Пожалуйста, сообщайте, если что-то не работает.

QuickDesk работает в macOS 11 и новее на Apple Silicon (M1 и новее). В Терминале выполните curl -fsSL https://quickdesk.click/install.sh | bash: команда положит QuickDesk.app в «Программы» и откроет его. Или скачайте .dmg со страницы загрузки и перетащите QuickDesk в «Программы».

Первый запуск. QuickDesk пока не нотаризован Apple, поэтому если .dmg скачан через браузер, macOS останавливает первый запуск сообщением о том, что Apple не может проверить его на наличие вредоносного ПО. С приложением всё в порядке; один раз сделайте одно из двух (при установке командой предупреждения не будет):

1. Откройте QuickDesk из «Программ» и нажмите Готово, когда macOS покажет предупреждение. Затем откройте «Системные настройки → Конфиденциальность и безопасность», прокрутите до раздела «Безопасность», нажмите Всё равно открыть рядом с сообщением о блокировке «QuickDesk», подтвердите паролем или Touch ID и нажмите Открыть. В macOS 14 и старше подойдёт и щелчок по QuickDesk с Control → Открыть → Открыть.
2. Или выполните в Терминале xattr -dr com.apple.quarantine /Applications/QuickDesk.app, а затем откройте QuickDesk как обычно.

Те же шаги есть на странице загрузки.

• QuickDesk живёт в строке меню, без значка в Dock. Его всплывающие окна открываются в том пространстве (Space), где вы находитесь, в том числе поверх приложения в полноэкранном режиме.
• Сочетания клавиш — ⌃ ⌥ N / V / P (Control + Option): ⌘⌥V и ⌘⌥N заняты Finder.
• Автовставка нажимает ⌘V в приложении, где вы работали, а macOS разрешает это, только когда вы добавите QuickDesk в «Системные настройки → Конфиденциальность и безопасность → Универсальный доступ». macOS спросит, когда вы впервые выберете запись; до тех пор запись копируется, и ⌘V нажимаете вы. Есть ли разрешение, видно в Settings → Auto-paste.
• Новые версии macOS могут спросить, разрешено ли QuickDesk читать то, что копируют другие приложения. Выберите «Разрешить», иначе история буфера обмена останется пустой.
• Использование Claude: на Mac Claude Code хранит вход в Связке ключей. Вкладка AI предлагает прочитать его оттуда; macOS спросит один раз (выберите Разрешать всегда). Как и в других системах, данные входа только читаются и отправляются только на api.anthropic.com.
• Поскольку приложение подписано ad hoc, после обновления macOS может снова запросить разрешения на Универсальный доступ и Связку ключей. Если автовставка перестала работать, удалите QuickDesk из списка Универсального доступа и добавьте снова.
• Вкладка Runtimes работает так же, как в Linux, с вашей оболочкой входа (zsh: ~/.zshrc). Установленные через Homebrew копии показываются, но не изменяются.

Удаление: выйдите из QuickDesk через строку меню и перетащите его из «Программ» в Корзину. Ваши данные остаются в ~/Library/Application Support/click.quickdesk, пока вы не удалите эту папку.

Сочетания клавиш

Повторное нажатие сочетания, когда его окно открыто, закрывает окно. Любое из них меняется в Settings → Hotkeys; QuickDesk предупредит, если сочетание уже занято.

В GNOME сочетания добавляются в Настройки → Клавиатура → Пользовательские сочетания и удаляются при выходе из QuickDesk, поэтому они работают и в Wayland. В других окружениях назначьте quickdesk toggle notes, quickdesk toggle clipboard, quickdesk toggle ports или quickdesk toggle quick-note на клавиши в настройках клавиатуры.

Почему Super + Alt? Вьетнамские методы ввода, такие как Unikey и Bamboo, перехватывают Super + Shift + буква, пока вы печатаете в текстовом поле; сочетания с Alt продолжают работать.

Заметки

Заметки — это Markdown с визуальным редактором: заголовки, жирный и курсив, списки, чек-листы, цитаты и блоки кода. Ctrl N — новая заметка, Ctrl S — сохранить, Ctrl F — поиск. Поиск не учитывает диакритику, поэтому tieng viet находит «tiếng Việt».

Закрепите заметку звёздочкой, чтобы держать её наверху. Перед удалением спрашивается подтверждение, а удаление можно отменить в течение нескольких секунд.

Синхронизация заметок между компьютерами

Заметки синхронизируются через QuickDesk Cloud. Ни учётной записи, ни почты: один компьютер получает код синхронизации, а остальные подключаются по нему. Синхронизируются только заметки; история буфера обмена и настройки остаются на каждом компьютере.

Настройка

1. На первом компьютере: Settings → Sync → Turn on sync и выберите парольную фразу (не короче 8 символов).
2. QuickDesk покажет ваш код синхронизации (QD1-…) и ключ восстановления. Сохраните ключ восстановления в надёжном месте: он показывается только один раз.
3. На каждом другом компьютере: Settings → Sync → I have a sync code, затем введите код и ту же парольную фразу (или ключ восстановления).

Код синхронизации можно снова показать в любой момент кнопкой Show sync code в Settings → Sync.

Когда происходит синхронизация

• Через пару секунд после правки заметки и при открытии окна QuickDesk.
• В остальное время QuickDesk проверяет изменения раз в минуту, пока открыто окно, и раз в 5 минут, пока он в трее. Проверка — это один маленький запрос; заметки передаются, только если что-то изменилось.
• Sync now проверяет сразу. Правки, сделанные без сети, отправляются, когда вы снова в сети.
• Если заметку изменили на двух компьютерах одновременно, сохраняются обе версии: более новая остаётся, другая становится копией рядом. Правка важнее удаления.

Конфиденциальность и ключи

• Заметки шифруются на вашем компьютере до отправки (XChaCha20-Poly1305, ключ из вашей парольной фразы через Argon2id). QuickDesk Cloud хранит только шифротекст под случайным идентификатором учётной записи и не может прочитать ваши заметки.
• Нужны оба: код синхронизации (чтобы добраться до данных) и парольная фраза (чтобы расшифровать их). Обращайтесь с кодом как с паролем: даже с ним одним кто-то может удалить ваши синхронизированные заметки.
• Забыли парольную фразу? Введите вместо неё ключ восстановления. Без них копию в QuickDesk Cloud открыть нельзя, но заметки на каждом компьютере останутся нетронутыми.
• Если QuickDesk просит Unlock sync (например, после сброса системной связки ключей), введите парольную фразу снова.

Отключение

Turn off sync… останавливает синхронизацию на одном компьютере и сохраняет его заметки. Отметьте Also delete my notes from QuickDesk Cloud, чтобы удалить синхронизированную копию для всех компьютеров.

Ограничения на один код синхронизации: 256 МБ и 20 000 хранимых объектов — гораздо больше, чем нужно заметкам.

История буфера обмена

Сохраняется всё, что вы копируете: текст, изображения (скриншоты) и файлы, скопированные в файловом менеджере. Откройте окно сочетанием Super Alt V, начните печатать для поиска, фильтруйте по тексту, изображениям или файлам и нажмите Enter, чтобы вставить в приложение, где вы работали. Ctrl Enter только копирует, Ctrl P закрепляет, Del удаляет.

• История остаётся на этом компьютере и никогда не синхронизируется.
• То, что менеджеры паролей помечают как секретное, пропускается. Прежде чем скопировать что-то важное, приостановите сохранение на 15 минут, час или до повторного включения (на вкладке Clipboard или в меню трея).
• QuickDesk хранит последние 1000 записей; закреплённые — навсегда. Текст до 1 МБ, изображения до 10 МБ каждое и до 200 МБ всего.
• Clear… на вкладке Clipboard удаляет всё, кроме закреплённых записей.

Автовставка

Когда вы выбираете запись, QuickDesk возвращается в приложение, где вы работали, и нажимает Shift Insert — это работает и в терминалах. Способ выбирается в Settings → Auto-paste:

• Desktop portal (по умолчанию): GNOME один раз просит разрешение и показывает индикатор удалённого управления во время вставки.
• Instant (virtual keyboard): без вопросов и индикатора. При включении один раз нужен пароль администратора, чтобы программы, запущенные от вашего имени, могли создавать виртуальную клавиатуру (то же разрешение, что Steam использует для геймпадов).

Выключите автовставку на вкладке Clipboard, чтобы только копировать, а затем нажимайте Ctrl V сами.

Порты

Super Alt P показывает все прослушиваемые TCP-порты (IPv4 и IPv6) с процессом, его полной командной строкой и пользователем; список обновляется каждые 2 секунды. Фильтруйте по порту, PID, процессу или имени контейнера.

• Open открывает http://localhost:<port> в браузере; Copy PID и Copy cmd копируют их.
• Kill сначала спрашивает, затем вежливо останавливает процесс и предлагает принудительное завершение, только если он не закрылся.
• Для портов, опубликованных Docker, показываются контейнер и образ, а Stop останавливает контейнер вместо того, чтобы убивать docker-proxy.
• Процессы других пользователей (системные службы) показываются скрытыми; чтобы их изучить, нужен root.

Версии языков (Runtimes)

Вкладка Runtimes управляет версиями языков программирования на этом компьютере (Node.js, Python, Rust, Go, Java, Ruby, Deno, Bun, PHP). Она показывает версию, которую запускает новый терминал, и откуда она берётся. QuickDesk спрашивает вашу оболочку входа, поэтому это именно то, что вы получаете после ~/.bashrc или ~/.zshrc, а не то, что видит рабочий стол.

• Языки, установленные через nvm (Node.js), rustup (Rust), uv (Python) или mise (Go, Java, Ruby, Deno, Bun, PHP и другие), можно менять: Install version… выбирает из версий, которые предлагает инструмент (rustup принимает введённый вами канал или версию), Make default задаёт, что будут использовать новые терминалы, Uninstall удаляет версию и освобождает место. Версию по умолчанию удалить нельзя — сначала выберите другую.
• Установка идёт в фоне с индикатором прогресса, её можно отменить. Одновременно выполняется только одно изменение. Список версий по умолчанию показывает последний выпуск каждой ветки; можно переключиться на LTS или на все версии либо ввести текст для фильтра.
• Когда выходит новый выпуск установленной ветки (Node 22.24.1 вместо 22.23.3, Python 3.13.9 вместо 3.13.7), у версии появляется ↑ 22.24.1: один щелчок ставит её и, если старая была версией по умолчанию, делает новую версией по умолчанию. Старая версия остаётся, пока вы её не удалите. Каналы Rust обновляются на месте: stable показывает ↑ 1.93.0, когда у rustup есть более новый stable, а щелчок запускает rustup update stable.
• Apply right away in open terminals (вверху вкладки) доставляет изменения в уже открытые терминалы начиная со следующего приглашения: QuickDesk добавляет в файл оболочки строку, которая загружает небольшой хук приглашения (~/.config/quickdesk/shell/hook.sh). Хук заставляет оболочку заново искать команды после того, как QuickDesk сменил версию, и заставляет Node следовать ближайшему .nvmrc, когда вы делаете cd в проект, а иначе — выбранной версии по умолчанию (ручной nvm use действует, пока вы не смените папку или версию по умолчанию). Без хука изменения Rust всё равно применяются сразу, изменения Python и mise доходят до новых терминалов (или до открытого после hash -r), а изменения nvm — только до новых терминалов.
• Set for a project… записывает собственный файл инструмента в выбранную вами папку: .nvmrc, rust-toolchain.toml, .python-version или mise.toml (mise сохраняет уже перечисленные там инструменты).
• Для языка без менеджера версий (например, Go из apt) есть Install mise…: QuickDesk скачивает последний mise с github.com/jdx/mise, сверяет его с SHA-256 выпуска и кладёт в ~/.local/bin. Когда вы сделаете версию версией по умолчанию, Fix PATH… предложит строку, которая включает mise в вашей оболочке.
• Если новые терминалы запускали бы другую копию, а не версию по умолчанию (например, системный python3 стоит в PATH раньше), карточка объясняет почему, а Fix PATH… показывает точные строки, которые будут добавлены. Только после вашего согласия QuickDesk добавит их отмеченным блоком в конец файла оболочки, оставив рядом резервную копию; блок можно убрать там же.
• Исправления PATH и хук приглашения пишутся для bash (~/.bashrc) и zsh (~/.zshrc); fish пока не поддерживается.
• Языки, которых ещё нет на компьютере, перечислены в Add a language: выберите язык, при необходимости установите mise, затем версию.
• Windows: QuickDesk спрашивает PowerShell, что запускает новый терминал, и работает через mise (устанавливается в %LOCALAPPDATA%\mise\bin), rustup и uv; nvm-windows и fnm показываются, но не изменяются, а заглушка python.exe из Магазина игнорируется. Fix PATH… ставит папки инструмента (для mise — его shims) в начало PATH вашей учётной записи, того, что в «Параметры → Переменные среды», без прав администратора; прежнее значение сохраняется в ~\.config\quickdesk\path, а та же панель снова убирает папки. Новые терминалы подхватывают изменения; после этого смена версии по умолчанию применяется сразу. «Apply right away» в Windows не нужен и не показывается.
• Копии, установленные системой (apt, dnf), никогда не изменяются и не удаляются; QuickDesk никогда не запускает sudo. Языки, которыми управляют неподдерживаемые инструменты (fnm, volta, pyenv, SDKMAN…), показываются только для чтения.

Использование ИИ

Кольцо в верхней панели показывает, какую часть лимитов ИИ вы уже израсходовали, — зелёным, жёлтым или красным. В его меню — отслеживаемый инструмент с полоской для каждого лимита и временем сброса; на вкладке AI — все инструменты.

• Claude Code: QuickDesk читает вход, который Claude Code уже сохранил на этом компьютере, и запрашивает у Anthropic ваше использование — не чаще раза в 5 минут. Токен только читается: никогда не сохраняется, не обновляется и не отправляется никуда, кроме Anthropic.
• Codex: читается из журналов сеансов, которые Codex хранит в ~/.codex.
• Gemini (Antigravity): процентов он не сообщает, поэтому QuickDesk по его журналам показывает, когда квота закончилась в последний раз.

Какой инструмент и лимит отслеживать, выберите в Track, или скройте кольцо на вкладке AI.

Обновления

QuickDesk проверяет новую версию через 30 секунд после запуска и затем каждые 6 часов. Когда она выходит, об этом сообщают баннер в главном окне и пункт в начале меню трея, вместе с What’s New. Ничего не устанавливается, пока вы не нажмёте Update Now.

Каждое обновление перед установкой проверяется ключом подписи QuickDesk. Для .deb или .rpm нужен пароль администратора; AppImage заменяет сам себя. Затем QuickDesk перезапускается и показывает, что изменилось. Отключить автоматическую проверку или проверить вручную можно в Settings → Updates.

Удаление

1. Выключите Start QuickDesk when I log in в Settings и выйдите из трея.
2. Удалите пакет: sudo apt remove quick-desk (Debian/Ubuntu) или sudo dnf remove QuickDesk (Fedora), либо удалите AppImage.
3. Ваши данные остаются в ~/.local/share/click.quickdesk, пока вы не удалите эту папку.

Windows: «Параметры → Приложения → Установленные приложения → QuickDesk → Удалить». Ваши данные остаются в %APPDATA%\click.quickdesk, пока вы не удалите эту папку.

Удаление пакета также убирает разрешение на мгновенную вставку, если вы его включали.

Устранение неполадок

• Сочетание клавиш ничего не делает: проверьте конфликты в Настройки → Клавиатура → Пользовательские сочетания или выберите другое сочетание в Settings → Hotkeys.
• Автовставка ничего не вводит: убедитесь, что приложение, в котором вы были, всё ещё в фокусе; смените способ в Settings → Auto-paste. Запись всегда копируется, поэтому Ctrl V работает.
• Журналы: ~/.local/share/click.quickdesk/logs/. Приложите их, когда сообщаете о проблеме.