Documentation

Installation

Le plus rapide, sur n’importe quelle distribution :

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

Il choisit le .deb, le .rpm ou l’AppImage pour votre système, vérifie son SHA-256 et l’installe (lire le script). Ou récupérez un paquet sur la page de téléchargement et installez le fichier téléchargé avec :

• 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
• Toute autre : rendez l’AppImage exécutable et lancez-la. Elle nécessite FUSE 2 (libfuse2, sur Ubuntu 24.04 libfuse2t64).

QuickDesk a besoin d’un système x86_64 de ces dernières années (glibc 2.34 ou plus récent). Il fonctionne au mieux sous GNOME, avec Wayland comme avec X11.

Windows 10 et 11 (64 bits) : dans PowerShell, lancez irm https://quickdesk.click/install.ps1 | iex, ou téléchargez l’installeur depuis la page de téléchargement. Il s’installe pour votre utilisateur seulement, sans droits d’administrateur. L’installeur n’est pas encore signé, Windows peut donc indiquer qu’il a protégé votre PC : choisissez Informations complémentaires → Exécuter quand même. Sous Windows, les raccourcis sont Win Alt N / V / P, QuickDesk vit dans la zone de notification et le collage automatique ne demande aucun réglage. L’onglet Runtimes y fonctionne via mise, rustup et uv (voir Versions des langages).

Au premier lancement, un écran de bienvenue présente les raccourcis et propose deux options : démarrer à l’ouverture de session (nécessaire pour que l’historique du presse-papiers et l’anneau d’IA fonctionnent en permanence) et collage instantané (voir Collage automatique). Ensuite, QuickDesk vit dans la barre supérieure.

macOS

Encore en développement. La version Mac fonctionne, mais elle est récente : tout n’a pas encore été essayé sur chaque Mac, et le collage automatique et les raccourcis sont encore en cours de mise au point. Merci de signaler ce qui ne marche pas.

QuickDesk fonctionne sur macOS 11 ou plus récent sur Apple Silicon (M1 et plus récent). Dans le Terminal, lancez curl -fsSL https://quickdesk.click/install.sh | bash : il place QuickDesk.app dans Applications et l’ouvre. Ou téléchargez le .dmg depuis la page de téléchargement et faites glisser QuickDesk dans Applications.

Premier lancement. QuickDesk n’est pas encore notarié par Apple : si le .dmg a été téléchargé dans un navigateur, macOS arrête le premier lancement en indiquant qu’« Apple ne peut pas vérifier qu’il ne contient pas de logiciel malveillant ». L’app n’a aucun problème ; faites l’une de ces deux choses une fois (installé avec la commande, aucun avertissement) :

1. Ouvrez QuickDesk depuis Applications et fermez l’avertissement de macOS. Ouvrez ensuite Réglages Système → Confidentialité et sécurité, faites défiler jusqu’à Sécurité, cliquez sur Ouvrir quand même à côté de « “QuickDesk” a été bloqué pour protéger votre Mac », confirmez avec votre mot de passe ou Touch ID et cliquez sur Ouvrir. Sur macOS 14 ou antérieur, Contrôle-clic sur QuickDesk → Ouvrir → Ouvrir fonctionne aussi.
2. Ou lancez xattr -dr com.apple.quarantine /Applications/QuickDesk.app dans le Terminal, puis ouvrez QuickDesk comme d’habitude.

La page de téléchargement montre les mêmes étapes.

• QuickDesk vit dans la barre des menus, sans icône dans le Dock. Ses fenêtres surgissantes s’ouvrent sur l’Espace où vous êtes, y compris par-dessus une app en plein écran.
• Les raccourcis sont ⌃ ⌥ N / V / P (Contrôle + Option) : ⌘⌥V et ⌘⌥N appartiennent au Finder.
• Le collage automatique appuie sur ⌘V dans l’app que vous utilisiez, ce que macOS n’autorise qu’après avoir ajouté QuickDesk dans Réglages Système → Confidentialité et sécurité → Accessibilité. macOS le demande la première fois que vous choisissez une entrée ; d’ici là, l’entrée est copiée et c’est vous qui appuyez sur ⌘V. Settings → Auto-paste indique si c’est autorisé.
• Les versions récentes de macOS peuvent demander si QuickDesk peut lire ce que copient les autres apps. Choisissez Autoriser, sinon l’historique du presse-papiers reste vide.
• Utilisation de Claude : sur Mac, Claude Code garde sa connexion dans le Trousseau. L’onglet AI propose de l’y lire ; macOS demande alors une fois (choisissez Toujours autoriser). Comme sur les autres systèmes, la connexion est seulement lue et n’est envoyée qu’à api.anthropic.com.
• Comme l’app est signée ad hoc, macOS peut redemander l’accès à l’Accessibilité et au Trousseau après une mise à jour. Si le collage automatique ne fonctionne plus, retirez QuickDesk de la liste Accessibilité et ajoutez-le de nouveau.
• L’onglet Runtimes fonctionne comme sous Linux, avec votre shell de connexion (zsh : ~/.zshrc). Les copies installées avec Homebrew sont affichées mais pas modifiées.

Désinstaller : quittez QuickDesk depuis la barre des menus et placez-le d’Applications dans la Corbeille. Vos données restent dans ~/Library/Application Support/click.quickdesk jusqu’à ce que vous supprimiez ce dossier.

Raccourcis

Appuyer de nouveau sur un raccourci quand sa fenêtre est ouverte la ferme. Changez-les dans Settings → Hotkeys ; QuickDesk prévient quand une combinaison est déjà prise.

Sous GNOME, les raccourcis sont ajoutés à Paramètres → Clavier → Raccourcis personnalisés et retirés quand QuickDesk se ferme, ils fonctionnent donc aussi sous Wayland. Sur les autres bureaux, associez quickdesk toggle notes, quickdesk toggle clipboard, quickdesk toggle ports ou quickdesk toggle quick-note à des touches dans les réglages du clavier de votre bureau.

Pourquoi Super + Alt ? Les méthodes de saisie vietnamiennes comme Unikey et Bamboo avalent Super + Maj + lettre pendant que vous tapez dans un champ de texte ; les combinaisons avec Alt continuent de fonctionner.

Notes

Les notes sont en Markdown, avec un éditeur enrichi : titres, gras et italique, listes, listes de tâches, citations et blocs de code. Ctrl N crée une note, Ctrl S enregistre, Ctrl F cherche. La recherche ignore les accents : tieng viet trouve « tiếng Việt ».

Épinglez une note avec l’étoile pour la garder en haut. La suppression demande une confirmation et peut être annulée pendant quelques secondes.

Synchroniser les notes entre ordinateurs

Les notes se synchronisent via QuickDesk Cloud. Ni compte ni e-mail : un ordinateur reçoit un code de synchronisation, et vos autres ordinateurs le rejoignent avec ce code. Seules les notes se synchronisent ; l’historique du presse-papiers et les réglages restent sur chaque ordinateur.

La mettre en place

1. Sur le premier ordinateur : Settings → Sync → Turn on sync, puis choisissez une phrase secrète (au moins 8 caractères).
2. QuickDesk affiche votre code de synchronisation (QD1-…) et une clé de récupération. Gardez la clé de récupération en lieu sûr ; elle n’est affichée qu’une fois.
3. Sur chaque autre ordinateur : Settings → Sync → I have a sync code, puis saisissez le code et la même phrase secrète (ou la clé de récupération).

Le code de synchronisation peut être réaffiché à tout moment avec Show sync code dans Settings → Sync.

Quand elle a lieu

• Quelques secondes après la modification d’une note, et à l’ouverture d’une fenêtre de QuickDesk.
• Sinon, QuickDesk cherche des changements chaque minute tant qu’une fenêtre est ouverte, et toutes les 5 minutes quand il est dans la barre. Une vérification est une seule petite requête ; les notes ne transitent que si quelque chose a changé.
• Sync now vérifie tout de suite. Les modifications faites hors ligne sont envoyées à votre retour en ligne.
• Si une note a changé sur deux ordinateurs en même temps, les deux versions sont conservées : la plus récente reste, l’autre devient une copie à côté. Une modification l’emporte sur une suppression.

Confidentialité et clés

• Les notes sont chiffrées sur votre ordinateur avant l’envoi (XChaCha20-Poly1305, clé dérivée de votre phrase secrète par Argon2id). QuickDesk Cloud ne conserve que du texte chiffré sous un identifiant de compte aléatoire et ne peut pas lire vos notes.
• Il faut à la fois le code de synchronisation (pour atteindre les données) et la phrase secrète (pour les déchiffrer). Traitez le code comme un mot de passe : avec lui seul, quelqu’un pourrait quand même supprimer vos notes synchronisées.
• Phrase secrète oubliée ? Saisissez plutôt la clé de récupération. Sans l’une ni l’autre, la copie dans QuickDesk Cloud ne peut pas être ouverte, mais les notes de chaque ordinateur restent intactes.
• Si QuickDesk demande de Unlock sync (par exemple après une réinitialisation du trousseau du système), saisissez de nouveau la phrase secrète.

La désactiver

Turn off sync… arrête la synchronisation sur un ordinateur et garde ses notes. Cochez Also delete my notes from QuickDesk Cloud pour supprimer la copie synchronisée pour tous les ordinateurs.

Limites par code de synchronisation : 256 Mo et 20 000 objets stockés, bien plus que ce dont des notes ont besoin.

Historique du presse-papiers

Tout ce que vous copiez est enregistré : texte, images (captures d’écran) et fichiers copiés dans votre gestionnaire de fichiers. Ouvrez la fenêtre avec Super Alt V, tapez pour chercher, filtrez par texte, images ou fichiers, et appuyez sur Entrée pour coller dans l’app que vous utilisiez. Ctrl Entrée copie seulement, Ctrl P épingle, Suppr supprime.

• L’historique reste sur cet ordinateur et ne se synchronise jamais.
• Les copies que les gestionnaires de mots de passe marquent comme secrètes sont ignorées. Avant de copier quelque chose de sensible, suspendez l’enregistrement 15 minutes, une heure ou jusqu’à ce que vous le réactiviez (dans l’onglet Clipboard ou le menu de la barre).
• QuickDesk garde les 1 000 dernières entrées ; les épinglées pour toujours. Texte jusqu’à 1 Mo, images jusqu’à 10 Mo chacune et 200 Mo au total.
• Clear… dans l’onglet Clipboard supprime tout sauf les entrées épinglées.

Collage automatique

Quand vous choisissez une entrée, QuickDesk revient à l’app que vous utilisiez et appuie sur Maj Inser, qui fonctionne aussi dans les terminaux. Choisissez la méthode dans Settings → Auto-paste :

• Desktop portal (par défaut) : GNOME demande la permission une fois et affiche un indicateur de contrôle à distance pendant le collage.
• Instant (virtual keyboard) : ni demande ni indicateur. L’activer demande une fois votre mot de passe administrateur pour autoriser les programmes lancés en votre nom à créer un clavier virtuel (la même autorisation que celle utilisée par Steam pour les manettes).

Désactivez le collage automatique dans l’onglet Clipboard pour seulement copier, puis appuyez vous-même sur Ctrl V.

Ports

Super Alt P liste chaque port TCP en écoute (IPv4 et IPv6) avec le processus, sa ligne de commande complète et son utilisateur, actualisés toutes les 2 secondes. Filtrez par port, PID, processus ou nom de conteneur.

• Open ouvre http://localhost:<port> dans votre navigateur ; Copy PID et Copy cmd les copient.
• Kill demande d’abord, puis arrête le processus poliment et ne propose de le forcer que s’il ne s’arrête pas.
• Les ports publiés par Docker affichent le conteneur et l’image, et Stop arrête le conteneur au lieu de tuer docker-proxy.
• Les processus d’autres utilisateurs (services du système) apparaissent masqués ; les examiner demande les droits root.

Versions des langages (Runtimes)

L’onglet Runtimes gère les versions des langages de programmation de cet ordinateur (Node.js, Python, Rust, Go, Java, Ruby, Deno, Bun, PHP). Il montre la version qu’exécute un nouveau terminal et d’où elle vient. QuickDesk interroge votre shell de connexion : c’est donc ce que vous obtenez après ~/.bashrc ou ~/.zshrc, et non ce que voit le bureau.

• Les langages installés avec nvm (Node.js), rustup (Rust), uv (Python) ou mise (Go, Java, Ruby, Deno, Bun, PHP et les autres) peuvent être modifiés : Install version… choisit parmi les versions que propose l’outil (rustup accepte un canal ou une version que vous tapez), Make default définit ce qu’utilisent les nouveaux terminaux, Uninstall en supprime une et libère sa place. La version par défaut ne peut pas être supprimée ; choisissez d’abord une autre version par défaut.
• Les installations tournent en arrière-plan avec une barre de progression et peuvent être annulées. Un seul changement s’exécute à la fois. La liste des versions montre par défaut la dernière version de chaque branche ; passez aux LTS ou à tout, ou tapez pour filtrer.
• Quand une version plus récente d’une branche installée sort (Node 22.24.1 pour 22.23.3, Python 3.13.9 pour 3.13.7), la version affiche ↑ 22.24.1 : un clic l’installe et, si l’ancienne était la version par défaut, la rend par défaut. L’ancienne reste jusqu’à ce que vous la désinstalliez. Les canaux Rust sont mis à jour sur place : stable affiche ↑ 1.93.0 quand rustup a un stable plus récent, et le clic lance rustup update stable.
• Apply right away in open terminals (en haut de l’onglet) fait arriver les changements dans les terminaux déjà ouverts, dès leur prochaine invite : QuickDesk ajoute une ligne à votre fichier de shell qui charge un petit hook d’invite (~/.config/quickdesk/shell/hook.sh). Le hook fait rechercher les commandes au shell après que QuickDesk a changé une version, et fait suivre à Node le .nvmrc le plus proche quand vous faites cd dans un projet, sinon la version par défaut que vous choisissez (un nvm use manuel tient jusqu’au changement de dossier ou de version par défaut). Sans lui, les changements de Rust s’appliquent quand même tout de suite, ceux de Python et de mise arrivent dans les nouveaux terminaux (ou dans un terminal ouvert après hash -r), et ceux de nvm dans les nouveaux terminaux seulement.
• Set for a project… écrit le fichier propre à l’outil dans le dossier de votre choix : .nvmrc, rust-toolchain.toml, .python-version ou mise.toml (mise garde les autres outils déjà listés).
• Un langage sans gestionnaire de versions (Go installé par apt, par exemple) propose Install mise… : QuickDesk télécharge le dernier mise depuis github.com/jdx/mise, le vérifie avec les sommes SHA-256 de la version et le place dans ~/.local/bin. Une fois une version rendue par défaut, Fix PATH… propose la ligne qui active mise dans votre shell.
• Si les nouveaux terminaux devaient exécuter une autre copie que celle par défaut (par exemple le python3 du système arrive en premier dans le PATH), la carte explique pourquoi et Fix PATH… montre exactement les lignes qu’il ajouterait. Ce n’est qu’après votre accord que QuickDesk les ajoute sous forme de bloc balisé à la fin de votre fichier de shell, avec une sauvegarde à côté ; le bloc peut être retiré au même endroit.
• Les corrections du PATH et le hook d’invite sont écrits pour bash (~/.bashrc) et zsh (~/.zshrc) ; fish n’est pas encore pris en charge.
• Les langages qui ne sont pas encore sur l’ordinateur sont listés sous Add a language : choisissez-en un pour installer mise si besoin, puis une version.
• Windows : QuickDesk demande à PowerShell ce qu’exécute un nouveau terminal et passe par mise (installé dans %LOCALAPPDATA%\mise\bin), rustup et uv ; nvm-windows et fnm sont affichés mais pas modifiés, et le python.exe factice du Store est ignoré. Fix PATH… met les dossiers de l’outil (pour mise, ses shims) en tête du PATH de votre compte, celui de Paramètres → Variables d’environnement, sans droits d’administrateur ; l’ancienne valeur est gardée dans ~\.config\quickdesk\path et le même panneau retire de nouveau les dossiers. Les nouveaux terminaux la prennent en compte ; les changements de version par défaut s’appliquent ensuite tout de suite. « Apply right away » n’est pas nécessaire sous Windows et n’y est pas affiché.
• Les copies installées par le système (apt, dnf) ne sont jamais modifiées ni supprimées ; QuickDesk ne lance jamais sudo. Les langages gérés par des outils qu’il ne prend pas en charge (fnm, volta, pyenv, SDKMAN…) sont affichés en lecture seule.

Utilisation de l’IA

Un anneau dans la barre supérieure montre quelle part de vos limites d’IA vous avez utilisée, en vert, orange ou rouge. Son menu montre l’outil que vous suivez, avec une barre par limite et l’heure de réinitialisation ; l’onglet AI montre tous les outils.

• Claude Code : QuickDesk lit la connexion que Claude Code a déjà enregistrée sur cet ordinateur et demande votre utilisation à Anthropic, au plus toutes les 5 minutes. Le jeton est seulement lu : jamais stocké, renouvelé ni envoyé ailleurs qu’à Anthropic.
• Codex : lu dans les journaux de session que Codex garde dans ~/.codex.
• Gemini (Antigravity) : il n’indique pas de pourcentage, QuickDesk montre donc, d’après ses journaux, quand vous avez épuisé votre quota pour la dernière fois.

Choisissez l’outil et la limite à suivre dans Track, ou masquez l’anneau dans l’onglet AI.

Mises à jour

QuickDesk cherche une nouvelle version 30 secondes après son démarrage, puis toutes les 6 heures. Quand il y en a une, un bandeau dans la fenêtre principale et une entrée en haut du menu de la barre le signalent, avec What’s New. Rien n’est installé tant que vous ne cliquez pas sur Update Now.

Chaque mise à jour est vérifiée avec la clé de signature de QuickDesk avant d’être installée. Un .deb ou un .rpm demande votre mot de passe administrateur ; une AppImage se remplace elle-même. QuickDesk redémarre ensuite et montre ce qui a changé. Désactivez les vérifications automatiques, ou vérifiez à la main, dans Settings → Updates.

Désinstallation

1. Désactivez Start QuickDesk when I log in dans Settings, puis quittez depuis la barre.
2. Supprimez le paquet : sudo apt remove quick-desk (Debian/Ubuntu) ou sudo dnf remove QuickDesk (Fedora), ou supprimez l’AppImage.
3. Vos données restent dans ~/.local/share/click.quickdesk jusqu’à ce que vous supprimiez ce dossier.

Windows : Paramètres → Applications → Applications installées → QuickDesk → Désinstaller. Vos données restent dans %APPDATA%\click.quickdesk jusqu’à ce que vous supprimiez ce dossier.

Supprimer le paquet retire aussi l’autorisation de collage instantané, si vous l’aviez activée.

Dépannage

• Un raccourci ne fait rien : vérifiez s’il y a un conflit dans Paramètres → Clavier → Raccourcis personnalisés, ou choisissez une autre combinaison dans Settings → Hotkeys.
• Le collage automatique n’écrit rien : vérifiez que l’app où vous étiez a toujours le focus ; changez de méthode dans Settings → Auto-paste. L’entrée est toujours copiée, donc Ctrl V fonctionne.
• Journaux : ~/.local/share/click.quickdesk/logs/. Joignez-les quand vous signalez un problème.