Documentación

Instalación

La forma más rápida, en cualquier distribución:

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

Elige el .deb, .rpm o AppImage para tu sistema, comprueba su SHA-256 y lo instala (leer el script). O consigue un paquete en la página de descarga e instala el archivo descargado con:

• 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
• Cualquier otra: haz ejecutable el AppImage y ábrelo. Necesita FUSE 2 (libfuse2; en Ubuntu 24.04, libfuse2t64).

QuickDesk necesita un sistema x86_64 de los últimos años (glibc 2.34 o posterior). Funciona mejor en GNOME, tanto con Wayland como con X11.

Windows 10 y 11 (64 bits): en PowerShell, ejecuta irm https://quickdesk.click/install.ps1 | iex, o descarga el instalador desde la página de descarga. Se instala solo para tu usuario, sin permisos de administrador. El instalador aún no está firmado, así que Windows puede decir que protegió tu PC: elige Más información → Ejecutar de todas formas. En Windows los atajos son Win Alt N / V / P, QuickDesk vive en la bandeja del sistema y el pegado automático no necesita configuración. Allí la pestaña Runtimes funciona con mise, rustup y uv (consulta Versiones de lenguajes).

La primera vez, una pantalla de bienvenida muestra los atajos y ofrece dos opciones: iniciar al entrar en la sesión (necesario para que el historial del portapapeles y el anillo de IA funcionen siempre) y pegado instantáneo (consulta Pegado automático). Después, QuickDesk vive en la barra superior.

macOS

Aún en desarrollo. La versión para Mac funciona, pero es nueva: todavía no se ha probado todo en todos los Mac, y el pegado automático y los atajos se siguen puliendo. Por favor, cuéntanos lo que no funcione.

QuickDesk funciona en macOS 11 o posterior en Apple Silicon (M1 o posterior). En Terminal, ejecuta curl -fsSL https://quickdesk.click/install.sh | bash: coloca QuickDesk.app en Aplicaciones y lo abre. O descarga el .dmg desde la página de descarga y arrastra QuickDesk a Aplicaciones.

Abrirlo por primera vez. QuickDesk aún no está notarizado por Apple, así que, si el .dmg se descargó con el navegador, macOS detiene el primer arranque con el aviso de que «Apple no puede comprobar si contiene software malicioso». A la app no le pasa nada; haz una de estas dos cosas una vez (si lo instalaste con el comando, no aparece ningún aviso):

1. Abre QuickDesk desde Aplicaciones y cierra el aviso de macOS. Luego abre Ajustes del Sistema → Privacidad y seguridad, baja hasta Seguridad, haz clic en Abrir igualmente junto a «Se ha bloqueado “QuickDesk” para proteger tu Mac», confirma con tu contraseña o Touch ID y haz clic en Abrir. En macOS 14 o anterior también sirve Control-clic en QuickDesk → Abrir → Abrir.
2. O ejecuta xattr -dr com.apple.quarantine /Applications/QuickDesk.app en Terminal y abre QuickDesk como siempre.

La página de descarga muestra los mismos pasos.

• QuickDesk vive en la barra de menús, sin icono en el Dock. Sus ventanas emergentes se abren en el Espacio en el que estés, también encima de una app a pantalla completa.
• Los atajos son ⌃ ⌥ N / V / P (Control + Opción): ⌘⌥V y ⌘⌥N pertenecen al Finder.
• El pegado automático pulsa ⌘V en la app que estabas usando, y macOS solo lo permite después de que añadas QuickDesk en Ajustes del Sistema → Privacidad y seguridad → Accesibilidad. macOS lo pregunta la primera vez que eliges una entrada; hasta entonces la entrada se copia y tú pulsas ⌘V. Settings → Auto-paste muestra si está permitido.
• Las versiones recientes de macOS pueden preguntar si QuickDesk puede leer lo que copian otras apps. Elige Permitir, o el historial del portapapeles se quedará vacío.
• Uso de Claude: en un Mac, Claude Code guarda su inicio de sesión en el Llavero. La pestaña AI ofrece leerlo de ahí; macOS pregunta entonces una vez (elige Permitir siempre). Como en los demás sistemas, el inicio de sesión solo se lee y solo se envía a api.anthropic.com.
• Como la app está firmada de forma ad hoc, macOS puede volver a pedir los permisos de Accesibilidad y del Llavero tras una actualización. Si el pegado automático deja de funcionar, quita QuickDesk de la lista de Accesibilidad y vuelve a añadirlo.
• La pestaña Runtimes funciona como en Linux, con tu shell de inicio de sesión (zsh: ~/.zshrc). Las copias instaladas con Homebrew se muestran, pero no se modifican.

Desinstalar: sal de QuickDesk desde la barra de menús y muévelo de Aplicaciones a la Papelera. Tus datos se quedan en ~/Library/Application Support/click.quickdesk hasta que borres esa carpeta.

Atajos

Pulsar de nuevo un atajo con su ventana abierta la cierra. Cambia cualquiera en Settings → Hotkeys; QuickDesk avisa cuando una combinación ya está en uso.

En GNOME los atajos se añaden a Configuración → Teclado → Atajos personalizados y se quitan cuando QuickDesk se cierra, así que también funcionan en Wayland. En otros escritorios, asigna quickdesk toggle notes, quickdesk toggle clipboard, quickdesk toggle ports o quickdesk toggle quick-note a teclas en la configuración del teclado de tu escritorio.

¿Por qué Super + Alt? Los métodos de entrada vietnamitas, como Unikey y Bamboo, se tragan Super + Shift + letra mientras escribes en un campo de texto; las combinaciones con Alt siguen funcionando.

Notas

Las notas son Markdown con un editor enriquecido: títulos, negrita y cursiva, listas, listas de tareas, citas y bloques de código. Ctrl N crea una nota nueva, Ctrl S guarda, Ctrl F busca. La búsqueda ignora los acentos, así que tieng viet encuentra «tiếng Việt».

Fija una nota con la estrella para mantenerla arriba. Al borrar se pide confirmación, y se puede deshacer durante unos segundos.

Sincronizar notas entre equipos

Las notas se sincronizan a través de QuickDesk Cloud. No hay cuenta ni correo: un equipo recibe un código de sincronización y tus otros equipos se unen con él. Solo se sincronizan las notas; el historial del portapapeles y la configuración se quedan en cada equipo.

Configurarlo

1. En el primer equipo: Settings → Sync → Turn on sync, y elige una frase de contraseña (al menos 8 caracteres).
2. QuickDesk muestra tu código de sincronización (QD1-…) y una clave de recuperación. Guarda la clave de recuperación en un lugar seguro; solo se muestra una vez.
3. En cada uno de los otros equipos: Settings → Sync → I have a sync code, e introduce el código y la misma frase de contraseña (o la clave de recuperación).

Puedes volver a ver el código en cualquier momento con Show sync code en Settings → Sync.

Cuándo se sincroniza

• Un par de segundos después de editar una nota, y cuando abres una ventana de QuickDesk.
• Por lo demás, QuickDesk busca cambios cada minuto mientras hay una ventana abierta, y cada 5 minutos mientras está en la bandeja. Cada comprobación es una sola petición pequeña; las notas solo viajan cuando algo cambió.
• Sync now comprueba en el acto. Los cambios hechos sin conexión se envían cuando vuelves a estar en línea.
• Si una nota cambió en dos equipos a la vez, se conservan ambas versiones: la más reciente se queda y la otra pasa a ser una copia a su lado. Una edición gana a un borrado.

Privacidad y claves

• Las notas se cifran en tu equipo antes de subirse (XChaCha20-Poly1305, clave derivada de tu frase de contraseña con Argon2id). QuickDesk Cloud solo guarda texto cifrado bajo un identificador de cuenta aleatorio y no puede leer tus notas.
• Hacen falta las dos cosas: el código de sincronización (para llegar a los datos) y la frase de contraseña (para descifrarlos). Trata el código como una contraseña: con él solo, alguien podría borrar tus notas sincronizadas.
• ¿Olvidaste la frase de contraseña? Introduce la clave de recuperación. Sin ninguna de las dos, la copia de QuickDesk Cloud no se puede abrir, pero las notas de cada equipo no se tocan.
• Si QuickDesk pide Unlock sync (por ejemplo, tras restablecer el llavero del sistema), vuelve a introducir la frase de contraseña.

Desactivarla

Turn off sync… deja de sincronizar en un equipo y conserva sus notas. Marca Also delete my notes from QuickDesk Cloud para borrar la copia sincronizada para todos los equipos.

Límites por código de sincronización: 256 MB y 20.000 objetos guardados, mucho más de lo que necesitan unas notas.

Historial del portapapeles

Todo lo que copias se guarda: texto, imágenes (capturas de pantalla) y archivos copiados en tu gestor de archivos. Abre la ventana con Super Alt V, escribe para buscar, filtra por texto, imágenes o archivos y pulsa Enter para pegar en la app que estabas usando. Ctrl Enter solo copia, Ctrl P fija, Supr borra.

• El historial se queda en este equipo y nunca se sincroniza.
• Lo que los gestores de contraseñas marcan como secreto se omite. Antes de copiar algo delicado, pausa el guardado durante 15 minutos, una hora o hasta que lo reactives (en la pestaña Clipboard o en el menú de la bandeja).
• QuickDesk conserva las 1.000 entradas más recientes; las fijadas, para siempre. Texto de hasta 1 MB, imágenes de hasta 10 MB cada una y 200 MB en total.
• Clear… en la pestaña Clipboard borra todo salvo las entradas fijadas.

Pegado automático

Cuando eliges una entrada, QuickDesk vuelve a la app que estabas usando y pulsa Shift Insert, que también funciona en terminales. Elige cómo en Settings → Auto-paste:

• Desktop portal (predeterminado): GNOME pide permiso una vez y muestra un indicador de control remoto mientras pega.
• Instant (virtual keyboard): sin avisos ni indicador. Al activarlo, pide tu contraseña de administrador una vez para permitir que los programas que ejecutas tú creen un teclado virtual (el mismo permiso que usa Steam para los mandos).

Desactiva el pegado automático en la pestaña Clipboard para limitarte a copiar, y luego pulsa tú Ctrl V.

Puertos

Super Alt P muestra cada puerto TCP en escucha (IPv4 e IPv6) con su proceso, su línea de órdenes completa y su usuario, actualizado cada 2 segundos. Filtra por puerto, PID, proceso o nombre de contenedor.

• Open abre http://localhost:<port> en tu navegador; Copy PID y Copy cmd los copian.
• Kill pregunta primero, luego detiene el proceso con educación y solo ofrece forzar el cierre si no termina.
• Los puertos publicados por Docker muestran el contenedor y la imagen, y Stop detiene el contenedor en lugar de matar docker-proxy.
• Los procesos de otros usuarios (servicios del sistema) aparecen ocultos; examinarlos requiere root.

Versiones de lenguajes (Runtimes)

La pestaña Runtimes gestiona las versiones de los lenguajes de programación de este equipo (Node.js, Python, Rust, Go, Java, Ruby, Deno, Bun, PHP). Muestra la versión que ejecuta una terminal nueva y de dónde viene. QuickDesk pregunta a tu shell de inicio de sesión, así que esto es lo que obtienes después de ~/.bashrc o ~/.zshrc, no lo que ve el escritorio.

• Los lenguajes instalados con nvm (Node.js), rustup (Rust), uv (Python) o mise (Go, Java, Ruby, Deno, Bun, PHP y los demás) se pueden cambiar: Install version… elige entre las versiones que ofrece la herramienta (rustup acepta un canal o una versión que escribas), Make default fija lo que usan las terminales nuevas, Uninstall quita una y libera su espacio. La predeterminada no se puede quitar; elige antes otra predeterminada.
• Las instalaciones se ejecutan en segundo plano con una barra de progreso y se pueden cancelar. Solo se ejecuta un cambio a la vez. La lista de versiones muestra por defecto la última versión de cada rama; cambia a LTS o a todas, o escribe para filtrar.
• Cuando sale una versión más nueva de una rama instalada (Node 22.24.1 para 22.23.3, Python 3.13.9 para 3.13.7), la versión muestra ↑ 22.24.1: un clic la instala y, si la antigua era la predeterminada, la convierte en predeterminada. La antigua se queda hasta que la desinstales. Los canales de Rust se actualizan en su sitio: stable muestra ↑ 1.93.0 cuando rustup tiene un stable más nuevo, y el clic ejecuta rustup update stable.
• Apply right away in open terminals (arriba en la pestaña) hace que los cambios lleguen a las terminales ya abiertas, desde su siguiente prompt: QuickDesk añade una línea a tu archivo de shell que carga un pequeño hook del prompt (~/.config/quickdesk/shell/hook.sh). El hook hace que el shell vuelva a buscar las órdenes después de que QuickDesk cambie una versión, y que Node siga el .nvmrc más cercano cuando entras con cd en un proyecto, o si no la predeterminada que elijas (un nvm use manual se mantiene hasta que cambies de carpeta o de predeterminada). Sin él, los cambios de Rust se aplican igualmente al momento, los de Python y mise llegan a las terminales nuevas (o a una abierta tras hash -r) y los de nvm solo a las terminales nuevas.
• Set for a project… escribe el archivo propio de la herramienta en la carpeta que elijas: .nvmrc, rust-toolchain.toml, .python-version o mise.toml (mise conserva las demás herramientas que ya figuren ahí).
• Un lenguaje sin gestor de versiones (por ejemplo, Go instalado con apt) ofrece Install mise…: QuickDesk descarga el último mise de github.com/jdx/mise, lo comprueba con las sumas SHA-256 de la versión y lo coloca en ~/.local/bin. Después de que hagas predeterminada una versión, Fix PATH… ofrece la línea que activa mise en tu shell.
• Si las terminales nuevas fueran a ejecutar otra copia distinta de la predeterminada (por ejemplo, el python3 del sistema va primero en el PATH), la tarjeta explica por qué y Fix PATH… muestra exactamente las líneas que añadiría. Solo cuando aceptas, QuickDesk las añade como un bloque marcado al final de tu archivo de shell, con una copia de seguridad al lado; el bloque se puede quitar desde el mismo sitio.
• Los arreglos del PATH y el hook del prompt se escriben para bash (~/.bashrc) y zsh (~/.zshrc); fish aún no está soportado.
• Los lenguajes que todavía no están en el equipo aparecen en Add a language: elige uno para instalar mise si hace falta y luego una versión.
• Windows: QuickDesk pregunta a PowerShell qué ejecuta una terminal nueva y trabaja con mise (instalado en %LOCALAPPDATA%\mise\bin), rustup y uv; nvm-windows y fnm se muestran pero no se modifican, y el python.exe de marcador de posición de la Tienda se ignora. Fix PATH… pone las carpetas de la herramienta (para mise, sus shims) al principio del PATH de tu cuenta, el de Configuración → Variables de entorno, sin permisos de administrador; el valor anterior se guarda en ~\.config\quickdesk\path y el mismo panel vuelve a quitar las carpetas. Las terminales nuevas lo recogen; a partir de ahí, los cambios de predeterminada se aplican al momento. En Windows «Apply right away» no hace falta y no se muestra.
• Las copias instaladas por el sistema (apt, dnf) nunca se cambian ni se quitan; QuickDesk nunca ejecuta sudo. Los lenguajes gestionados por herramientas que no soporta (fnm, volta, pyenv, SDKMAN…) se muestran en solo lectura.

Uso de IA

Un anillo en la barra superior muestra cuánto has usado de tus límites de IA, en verde, ámbar o rojo. Su menú muestra la herramienta que sigues, con una barra por cada límite y cuándo se reinicia; la pestaña AI muestra todas las herramientas.

• Claude Code: QuickDesk lee el inicio de sesión que Claude Code ya guardó en este equipo y pregunta a Anthropic por tu uso, como mucho cada 5 minutos. El token solo se lee: nunca se guarda, se renueva ni se envía a ningún sitio salvo a Anthropic.
• Codex: se lee de los registros de sesión que Codex guarda en ~/.codex.
• Gemini (Antigravity): no informa de un porcentaje, así que QuickDesk muestra, a partir de sus registros, cuándo agotaste la cuota por última vez.

Elige qué herramienta y qué límite seguir en Track, u oculta el anillo en la pestaña AI.

Actualizaciones

QuickDesk busca una versión nueva 30 segundos después de arrancar y luego cada 6 horas. Cuando sale una, un aviso en la ventana principal y una entrada al principio del menú de la bandeja lo indican, con What’s New. No se instala nada hasta que haces clic en Update Now.

Cada actualización se verifica con la clave de firma de QuickDesk antes de instalarse. Un .deb o .rpm pide tu contraseña de administrador; un AppImage se reemplaza a sí mismo. Después QuickDesk se reinicia y muestra qué ha cambiado. Desactiva las comprobaciones automáticas, o comprueba a mano, en Settings → Updates.

Desinstalar

1. Desactiva Start QuickDesk when I log in en Settings y sal desde la bandeja.
2. Quita el paquete: sudo apt remove quick-desk (Debian/Ubuntu) o sudo dnf remove QuickDesk (Fedora), o borra el AppImage.
3. Tus datos se quedan en ~/.local/share/click.quickdesk hasta que borres esa carpeta.

Windows: Configuración → Aplicaciones → Aplicaciones instaladas → QuickDesk → Desinstalar. Tus datos se quedan en %APPDATA%\click.quickdesk hasta que borres esa carpeta.

Quitar el paquete también retira el permiso de pegado instantáneo, si lo activaste.

Solución de problemas

• Un atajo no hace nada: revisa si hay un conflicto en Configuración → Teclado → Atajos personalizados, o elige otra combinación en Settings → Hotkeys.
• El pegado automático no escribe nada: comprueba que la app en la que estabas sigue teniendo el foco; cambia el método en Settings → Auto-paste. La entrada siempre se copia, así que Ctrl V funciona.
• Registros: ~/.local/share/click.quickdesk/logs/. Adjúntalos cuando informes de un problema.