Dokumentasi

Instalasi

Cara tercepat, di distribusi mana pun:

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

Perintah ini memilih .deb, .rpm, atau AppImage untuk sistem Anda, memeriksa SHA-256-nya, lalu memasangnya (baca skripnya). Atau ambil paket di halaman unduhan dan pasang berkas yang diunduh dengan:

• 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
• Distribusi lain: jadikan AppImage dapat dieksekusi lalu buka. AppImage membutuhkan FUSE 2 (libfuse2; di Ubuntu 24.04, libfuse2t64).

QuickDesk membutuhkan sistem x86_64 dari beberapa tahun terakhir (glibc 2.34 atau lebih baru). Paling cocok di GNOME, baik di Wayland maupun X11.

Windows 10 dan 11 (64-bit): di PowerShell, jalankan irm https://quickdesk.click/install.ps1 | iex, atau unduh penginstal dari halaman unduhan. QuickDesk dipasang hanya untuk pengguna Anda, tanpa hak administrator. Penginstal belum ditandatangani, jadi Windows mungkin mengatakan telah melindungi PC Anda: pilih Info selengkapnya → Tetap jalankan. Di Windows, pintasannya Win Alt N / V / P, QuickDesk berada di system tray, dan tempel otomatis tidak perlu diatur. Di sana tab Runtimes bekerja dengan mise, rustup, dan uv (lihat Versi bahasa pemrograman).

Saat pertama kali, layar sambutan menampilkan pintasan dan menawarkan dua pilihan: mulai saat login (diperlukan agar riwayat clipboard dan cincin AI selalu berjalan) dan tempel instan (lihat Tempel otomatis). Setelah itu, QuickDesk berada di bar atas.

macOS

Masih dalam pengembangan. Versi Mac sudah berjalan, tetapi masih baru: belum semuanya diuji di setiap Mac, dan tempel otomatis serta pintasan masih terus disempurnakan. Mohon beri tahu kami apa yang tidak berfungsi.

QuickDesk berjalan di macOS 11 atau lebih baru di Apple Silicon (M1 atau lebih baru). Di Terminal, jalankan curl -fsSL https://quickdesk.click/install.sh | bash: perintah ini menaruh QuickDesk.app di Aplikasi lalu membukanya. Atau unduh .dmg dari halaman unduhan lalu seret QuickDesk ke Aplikasi.

Membukanya pertama kali. QuickDesk belum dinotarisasi oleh Apple, jadi jika .dmg diunduh lewat browser, macOS menghentikan pembukaan pertama dengan peringatan bahwa “Apple tidak dapat memverifikasi bahwa aplikasi ini bebas dari malware”. Tidak ada yang salah dengan aplikasinya; lakukan salah satu dari dua cara ini sekali (jika Anda memasang dengan perintah, tidak ada peringatan yang muncul):

1. Buka QuickDesk dari Aplikasi dan tutup peringatan macOS. Lalu buka Pengaturan Sistem → Privasi & Keamanan, gulir ke Keamanan, klik Tetap Buka di samping ““QuickDesk” diblokir untuk melindungi Mac Anda”, konfirmasi dengan kata sandi atau Touch ID, lalu klik Buka. Di macOS 14 atau versi lebih lama, Control-klik QuickDesk → Buka → Buka juga bisa.
2. Atau jalankan xattr -dr com.apple.quarantine /Applications/QuickDesk.app di Terminal lalu buka QuickDesk seperti biasa.

Halaman unduhan menampilkan langkah yang sama.

• QuickDesk berada di bar menu, tanpa ikon di Dock. Jendela pop-up-nya terbuka di Space tempat Anda berada, juga di atas aplikasi layar penuh.
• Pintasannya ⌃ ⌥ N / V / P (Control + Option): ⌘⌥V dan ⌘⌥N milik Finder.
• Tempel otomatis menekan ⌘V di aplikasi yang sedang Anda pakai, dan macOS hanya mengizinkannya setelah Anda menambahkan QuickDesk di Pengaturan Sistem → Privasi & Keamanan → Aksesibilitas. macOS menanyakannya saat pertama kali Anda memilih entri; sampai saat itu entri disalin dan Anda menekan ⌘V sendiri. Settings → Auto-paste menunjukkan apakah izinnya sudah diberikan.
• Versi macOS terbaru mungkin bertanya apakah QuickDesk boleh membaca apa yang disalin aplikasi lain. Pilih Izinkan, atau riwayat clipboard akan tetap kosong.
• Penggunaan Claude: di Mac, Claude Code menyimpan login-nya di Rantai Kunci. Tab AI menawarkan untuk membacanya dari sana; macOS lalu bertanya sekali (pilih Selalu Izinkan). Seperti di sistem lain, login hanya dibaca dan hanya dikirim ke api.anthropic.com.
• Karena aplikasinya ditandatangani secara ad hoc, macOS mungkin meminta izin Aksesibilitas dan Rantai Kunci lagi setelah pembaruan. Jika tempel otomatis berhenti berfungsi, hapus QuickDesk dari daftar Aksesibilitas lalu tambahkan lagi.
• Tab Runtimes bekerja seperti di Linux, dengan shell login Anda (zsh: ~/.zshrc). Salinan yang dipasang dengan Homebrew ditampilkan tetapi tidak diubah.

Mencopot: keluar dari QuickDesk lewat bar menu lalu pindahkan dari Aplikasi ke Tempat Sampah. Data Anda tetap di ~/Library/Application Support/click.quickdesk sampai Anda menghapus folder itu.

Pintasan

Menekan pintasan lagi saat jendelanya terbuka akan menutupnya. Ubah pintasan mana pun di Settings → Hotkeys; QuickDesk memberi tahu jika kombinasi sudah dipakai.

Di GNOME, pintasan ditambahkan ke Pengaturan → Papan Ketik → Pintasan Khusus dan dihapus saat QuickDesk ditutup, jadi juga berfungsi di Wayland. Di desktop lain, kaitkan quickdesk toggle notes, quickdesk toggle clipboard, quickdesk toggle ports, atau quickdesk toggle quick-note ke tombol di pengaturan keyboard desktop Anda.

Kenapa Super + Alt? Metode input bahasa Vietnam seperti Unikey dan Bamboo menelan Super + Shift + huruf saat Anda mengetik di kolom teks; kombinasi dengan Alt tetap berfungsi.

Catatan

Catatan adalah Markdown dengan editor kaya: judul, tebal dan miring, daftar, daftar tugas, kutipan, dan blok kode. Ctrl N membuat catatan baru, Ctrl S menyimpan, Ctrl F mencari. Pencarian mengabaikan tanda diakritik, jadi tieng viet menemukan “tiếng Việt”.

Sematkan catatan dengan bintang agar tetap di atas. Menghapus meminta konfirmasi dan bisa dibatalkan selama beberapa detik.

Menyinkronkan catatan antarkomputer

Catatan disinkronkan lewat QuickDesk Cloud. Tanpa akun dan tanpa email: satu komputer mendapat kode sinkronisasi dan komputer lain bergabung dengannya. Hanya catatan yang disinkronkan; riwayat clipboard dan pengaturan tetap di masing-masing komputer.

Mengaturnya

1. Di komputer pertama: Settings → Sync → Turn on sync, lalu pilih frasa sandi (minimal 8 karakter).
2. QuickDesk menampilkan kode sinkronisasi Anda (QD1-…) dan kunci pemulihan. Simpan kunci pemulihan di tempat aman; kunci itu hanya ditampilkan sekali.
3. Di setiap komputer lain: Settings → Sync → I have a sync code, lalu masukkan kode dan frasa sandi yang sama (atau kunci pemulihan).

Anda bisa melihat kode itu lagi kapan saja dengan Show sync code di Settings → Sync.

Kapan sinkronisasi berjalan

• Beberapa detik setelah Anda mengedit catatan, dan saat Anda membuka jendela QuickDesk.
• Selain itu, QuickDesk memeriksa perubahan setiap menit saat ada jendela terbuka, dan setiap 5 menit saat berada di tray. Setiap pemeriksaan hanya satu permintaan kecil; catatan baru dikirim jika ada yang berubah.
• Sync now memeriksa saat itu juga. Perubahan yang dibuat saat offline dikirim begitu Anda online lagi.
• Jika satu catatan berubah di dua komputer sekaligus, kedua versi disimpan: yang lebih baru tetap, yang lain menjadi salinan di sebelahnya. Suntingan menang atas penghapusan.

Privasi dan kunci

• Catatan dienkripsi di komputer Anda sebelum diunggah (XChaCha20-Poly1305, kunci diturunkan dari frasa sandi Anda dengan Argon2id). QuickDesk Cloud hanya menyimpan teks terenkripsi di bawah ID akun acak dan tidak bisa membaca catatan Anda.
• Diperlukan keduanya: kode sinkronisasi (untuk menjangkau data) dan frasa sandi (untuk mendekripsinya). Perlakukan kode itu seperti kata sandi: dengan kode itu saja, seseorang bisa menghapus catatan Anda yang tersinkron.
• Lupa frasa sandi? Masukkan kunci pemulihan. Tanpa keduanya, salinan di QuickDesk Cloud tidak bisa dibuka, tetapi catatan di setiap komputer tidak tersentuh.
• Jika QuickDesk meminta Unlock sync (misalnya setelah keyring sistem diatur ulang), masukkan lagi frasa sandi Anda.

Mematikannya

Turn off sync… menghentikan sinkronisasi di satu komputer dan tetap menyimpan catatannya. Centang Also delete my notes from QuickDesk Cloud untuk menghapus salinan tersinkron bagi semua komputer.

Batas per kode sinkronisasi: 256 MB dan 20.000 objek tersimpan, jauh lebih banyak daripada yang dibutuhkan catatan.

Riwayat clipboard

Semua yang Anda salin disimpan: teks, gambar (tangkapan layar), dan berkas yang disalin di pengelola berkas. Buka jendelanya dengan Super Alt V, ketik untuk mencari, saring berdasarkan teks, gambar, atau berkas, lalu tekan Enter untuk menempel ke aplikasi yang sedang Anda pakai. Ctrl Enter hanya menyalin, Ctrl P menyematkan, Delete menghapus.

• Riwayat tetap di komputer ini dan tidak pernah disinkronkan.
• Apa pun yang ditandai rahasia oleh pengelola kata sandi dilewati. Sebelum menyalin sesuatu yang sensitif, jeda penyimpanan selama 15 menit, satu jam, atau sampai Anda mengaktifkannya lagi (di tab Clipboard atau menu tray).
• QuickDesk menyimpan 1.000 entri terbaru; yang disematkan, selamanya. Teks hingga 1 MB, gambar hingga 10 MB per gambar dan 200 MB secara total.
• Clear… di tab Clipboard menghapus semuanya kecuali entri yang disematkan.

Tempel otomatis

Saat Anda memilih entri, QuickDesk kembali ke aplikasi yang sedang Anda pakai dan menekan Shift Insert, yang juga berfungsi di terminal. Pilih caranya di Settings → Auto-paste:

• Desktop portal (default): GNOME meminta izin sekali dan menampilkan indikator kendali jarak jauh saat menempel.
• Instant (virtual keyboard): tanpa permintaan izin dan tanpa indikator. Saat diaktifkan, meminta kata sandi admin sekali untuk mengizinkan program yang Anda jalankan membuat keyboard virtual (izin yang sama yang dipakai Steam untuk controller).

Matikan tempel otomatis di tab Clipboard untuk hanya menyalin, lalu tekan Ctrl V sendiri.

Port

Super Alt P menampilkan setiap port TCP yang mendengarkan (IPv4 dan IPv6) beserta prosesnya, baris perintah lengkapnya, dan penggunanya, diperbarui setiap 2 detik. Saring berdasarkan port, PID, proses, atau nama kontainer.

• Open membuka http://localhost:<port> di browser Anda; Copy PID dan Copy cmd menyalinnya.
• Kill bertanya dulu, lalu menghentikan proses dengan sopan dan baru menawarkan paksa jika proses tidak berhenti.
• Port yang dipublikasikan Docker menampilkan kontainer dan image-nya, dan Stop menghentikan kontainer alih-alih mematikan docker-proxy.
• Proses milik pengguna lain (layanan sistem) ditampilkan tersembunyi; memeriksanya membutuhkan root.

Versi bahasa pemrograman (Runtimes)

Tab Runtimes mengelola versi bahasa pemrograman di komputer ini (Node.js, Python, Rust, Go, Java, Ruby, Deno, Bun, PHP). Tab ini menampilkan versi yang dijalankan terminal baru dan dari mana asalnya. QuickDesk bertanya ke shell login Anda, jadi inilah yang Anda dapatkan setelah ~/.bashrc atau ~/.zshrc, bukan yang dilihat desktop.

• Bahasa yang dipasang dengan nvm (Node.js), rustup (Rust), uv (Python), atau mise (Go, Java, Ruby, Deno, Bun, PHP, dan lainnya) bisa diubah: Install version… memilih dari rilis yang ditawarkan alat itu (rustup menerima kanal atau versi yang Anda ketik), Make default menetapkan yang dipakai terminal baru, Uninstall menghapus satu versi dan membebaskan ruangnya. Versi default tidak bisa dihapus; pilih default lain dulu.
• Pemasangan berjalan di latar belakang dengan bilah kemajuan dan bisa dibatalkan. Hanya satu perubahan yang berjalan dalam satu waktu. Daftar versi secara default menampilkan rilis terbaru dari setiap seri; ganti ke LTS atau semua, atau ketik untuk menyaring.
• Saat ada rilis lebih baru dari seri yang terpasang (Node 22.24.1 untuk 22.23.3, Python 3.13.9 untuk 3.13.7), versi itu menampilkan ↑ 22.24.1: sekali klik memasangnya dan, jika versi lama adalah default, menjadikan yang baru default. Versi lama tetap ada sampai Anda mencopotnya. Kanal Rust diperbarui di tempat: stable menampilkan ↑ 1.93.0 saat rustup punya stable yang lebih baru, dan klik menjalankan rustup update stable.
• Apply right away in open terminals (di bagian atas tab) membuat perubahan sampai ke terminal yang sudah terbuka, mulai dari prompt berikutnya: QuickDesk menambahkan satu baris ke berkas shell Anda yang memuat hook prompt kecil (~/.config/quickdesk/shell/hook.sh). Hook ini membuat shell mencari ulang perintah setelah QuickDesk mengubah versi, dan membuat Node mengikuti .nvmrc terdekat saat Anda cd ke sebuah proyek, atau default yang Anda pilih jika tidak ada (nvm use manual tetap berlaku sampai Anda pindah folder atau mengganti default). Tanpa hook ini, perubahan Rust tetap langsung berlaku, perubahan Python dan mise sampai ke terminal baru (atau terminal terbuka setelah hash -r), dan perubahan nvm hanya ke terminal baru.
• Set for a project… menulis berkas milik alat itu di folder yang Anda pilih: .nvmrc, rust-toolchain.toml, .python-version, atau mise.toml (mise mempertahankan alat lain yang sudah tercantum di sana).
• Bahasa tanpa pengelola versi (misalnya Go yang dipasang dengan apt) menawarkan Install mise…: QuickDesk mengunduh mise terbaru dari github.com/jdx/mise, memeriksanya dengan checksum SHA-256 rilis itu, lalu menaruhnya di ~/.local/bin. Setelah Anda menjadikan sebuah versi default, Fix PATH… menawarkan baris yang mengaktifkan mise di shell Anda.
• Jika terminal baru akan menjalankan salinan yang berbeda dari default (misalnya python3 sistem lebih dulu di PATH), kartunya menjelaskan alasannya dan Fix PATH… menampilkan baris persis yang akan ditambahkan. Hanya setelah Anda setuju, QuickDesk menambahkannya sebagai blok bertanda di akhir berkas shell Anda, dengan cadangan di sebelahnya; blok itu bisa dihapus dari tempat yang sama.
• Perbaikan PATH dan hook prompt ditulis untuk bash (~/.bashrc) dan zsh (~/.zshrc); fish belum didukung.
• Bahasa yang belum ada di komputer muncul di Add a language: pilih satu untuk memasang mise jika perlu, lalu pilih versinya.
• Windows: QuickDesk bertanya ke PowerShell apa yang dijalankan terminal baru dan bekerja dengan mise (dipasang di %LOCALAPPDATA%\mise\bin), rustup, dan uv; nvm-windows dan fnm ditampilkan tetapi tidak diubah, dan python.exe penampung dari Microsoft Store diabaikan. Fix PATH… menaruh folder alat itu (untuk mise, shim-nya) di depan PATH akun Anda, yang ada di Pengaturan → Variabel lingkungan, tanpa hak administrator; nilai sebelumnya disimpan di ~\.config\quickdesk\path dan panel yang sama bisa menghapus folder itu lagi. Terminal baru akan memakainya; setelah itu, perubahan default langsung berlaku. Di Windows, “Apply right away” tidak diperlukan dan tidak ditampilkan.
• Salinan yang dipasang sistem (apt, dnf) tidak pernah diubah atau dihapus; QuickDesk tidak pernah menjalankan sudo. Bahasa yang dikelola alat yang tidak didukung (fnm, volta, pyenv, SDKMAN…) ditampilkan hanya-baca.

Penggunaan AI

Sebuah cincin di bar atas menunjukkan seberapa banyak batas AI yang sudah Anda pakai, dalam warna hijau, kuning, atau merah. Menunya menampilkan alat yang Anda pantau, dengan satu bar per batas dan kapan batas itu diatur ulang; tab AI menampilkan semua alat.

• Claude Code: QuickDesk membaca login yang sudah disimpan Claude Code di komputer ini dan menanyakan penggunaan Anda ke Anthropic, paling sering setiap 5 menit. Token hanya dibaca: tidak pernah disimpan, diperbarui, atau dikirim ke mana pun selain Anthropic.
• Codex: dibaca dari log sesi yang disimpan Codex di ~/.codex.
• Gemini (Antigravity): tidak melaporkan persentase, jadi QuickDesk menampilkan, dari log-nya, kapan terakhir kali Anda kehabisan kuota.

Pilih alat dan batas mana yang dipantau di Track, atau sembunyikan cincinnya di tab AI.

Pembaruan

QuickDesk memeriksa rilis baru 30 detik setelah mulai, lalu setiap 6 jam. Saat ada rilis baru, banner di jendela utama dan entri di bagian atas menu tray memberi tahu, dengan What’s New. Tidak ada yang dipasang sampai Anda mengklik Update Now.

Setiap pembaruan diverifikasi dengan kunci penandatanganan QuickDesk sebelum dipasang. Paket .deb atau .rpm meminta kata sandi admin; AppImage mengganti dirinya sendiri. Setelah itu QuickDesk memulai ulang dan menampilkan apa yang berubah. Matikan pemeriksaan otomatis, atau periksa secara manual, di Settings → Updates.

Mencopot

1. Matikan Start QuickDesk when I log in di Settings lalu keluar dari tray.
2. Hapus paketnya: sudo apt remove quick-desk (Debian/Ubuntu) atau sudo dnf remove QuickDesk (Fedora), atau hapus AppImage-nya.
3. Data Anda tetap di ~/.local/share/click.quickdesk sampai Anda menghapus folder itu.

Windows: Pengaturan → Aplikasi → Aplikasi yang diinstal → QuickDesk → Copot pemasangan. Data Anda tetap di %APPDATA%\click.quickdesk sampai Anda menghapus folder itu.

Menghapus paket juga mencabut izin tempel instan, jika Anda mengaktifkannya.

Pemecahan masalah

• Pintasan tidak berfungsi: periksa konflik di Pengaturan → Papan Ketik → Pintasan Khusus, atau pilih kombinasi lain di Settings → Hotkeys.
• Tempel otomatis tidak mengetik apa pun: pastikan aplikasi tempat Anda tadi masih punya fokus; ganti caranya di Settings → Auto-paste. Entri selalu disalin, jadi Ctrl V tetap berfungsi.
• Log: ~/.local/share/click.quickdesk/logs/. Lampirkan saat Anda melaporkan masalah.