# Glass Power Tools

> One app for the machines you work on — SSH terminal, databases (MySQL, PostgreSQL, SQLite), remote desktops (RDP, VNC) and a code editor — built natively for Apple Vision Pro, Mac, iPad and iPhone. Free software under the GPLv3.

## Pages

- [Databases — Glass Power Tools](https://glasspowertools.com/databases.html): MySQL, PostgreSQL and SQLite: browse, filter and edit rows with a review before every write, run and explain SQL, over TLS or SSH.
- [Remote desktops — Glass Power Tools](https://glasspowertools.com/desktops.html): RDP and VNC desktops that follow your window's size and adapt to the link, with certificate checks before sign-in, audio, a shared clipboard with text, formatting and images, and glass on Mac and Vision Pro.
- [Editor — Glass Power Tools](https://glasspowertools.com/editor.html): Edit files on this device or on a server over SFTP. Projects with a file tree, fifteen highlighted languages, Markdown, HTML, SVG and CSV previews, and 3D models.
- [Glass Power Tools — the machines you work on, in one list](https://glasspowertools.com/): Terminals, databases, remote desktops and an editor for Apple Vision Pro, Mac, iPad and iPhone. One library of your machines. Free software, under the GPLv3.
- [Terminal — Glass Power Tools](https://glasspowertools.com/terminal.html): SSH with host-key pinning, key and Secure Enclave sign-in, tabs, workgroups, port forwarding and SFTP. A local shell on the Mac.
- [Why one app — Glass Power Tools](https://glasspowertools.com/why.html): One library of your machines instead of one app per protocol: how the host model works, why Vision Pro leads, and what the app is not.
- [Security](https://glasspowertools.com/security.html): How Glass Power Tools protects credentials and connections, what it does not protect, and how to report a problem.

## Help: Your machines

- [Browse your machines](https://glasspowertools.com/help/library-browse.html): How the library is laid out on each device, how to search it, and what a host's details and this device's host show.
- [Add a machine and its services](https://glasspowertools.com/help/library-add-host.html): Add a host with a Terminal, Database or Desktop service, add more services, edit them, and remove services or hosts.
- [Connect and switch between sessions](https://glasspowertools.com/help/library-connect.html): Use the Connect controls and the Mac's Command Palette, switch to or close open sessions from Active and the lightning button, see everything open with Show All Windows, and shrink windows into orbs on Vision Pro.
- [Widgets](https://glasspowertools.com/help/library-widgets.html): The Machines, Machine and Active widgets on iPhone, iPad, Vision Pro and Mac: where they go, what they show, and what choosing them does.
- [Siri, Shortcuts and the rest of the system](https://glasspowertools.com/help/library-siri-and-system.html): Siri phrases and Shortcuts actions, sending files to a machine, Spotlight, Controls, Handoff, dragging a service into its own window, ssh:// links, and on the Mac the Finder's Services, toolbar button and Quick Action, Open With and the Dock menu.
- [Favorites, collections and other names](https://glasspowertools.com/help/library-organize.html): Mark favorites, find recent hosts, group hosts into collections, and give a host other names that search and matching use.
- [Manage SSH keys](https://glasspowertools.com/help/library-ssh-keys.html): Import keys or generate them in the Secure Enclave, see which services use a key, and copy, export, rename or delete keys.
- [Your library on all your devices](https://glasspowertools.com/help/library-sync.html): What iCloud syncs and what stays on one device, when syncing happens, how to check its status, and how conflicts resolve.
- [Settings and window appearance](https://glasspowertools.com/help/library-settings.html): Open Settings on each device, choose Light or Dark, set window opacity and glass, and read the General, Privacy and About pages.

## Help: Terminal

- [Connect to a machine over SSH](https://glasspowertools.com/help/terminal-connect.html): Set up a Terminal service, connect, enter passwords, route through jump hosts, allow legacy algorithms, and recover from dropped connections.
- [Sign in with keys and trust host keys](https://glasspowertools.com/help/terminal-keys-and-trust.html): Sign in with an SSH or Secure Enclave key, install your public key, and trust or refuse a machine's host key.
- [Work in a terminal](https://glasspowertools.com/help/terminal-sessions.html): Terminal windows, tabs and splits, the layout toggle and the plus menu, the Mac window's sidebar, moving tabs between windows, what comes back after a relaunch, the tools menu, text size, scaling the text with the window, search, paste review, links and paths, previewing a printed path's file, selecting on Vision Pro, dropping files, snippets, recording and the Mac's local shell.
- [Keep terminals running with tmux](https://glasspowertools.com/help/terminal-tmux.html): Keep each terminal in its own tmux session, reconnect to it, pick it up from Active on another device or add it to a window as a tab, end it, open a basic terminal outside tmux, and keep the Mac's local terminals running in the background.
- [Browse and transfer files over SFTP](https://glasspowertools.com/help/terminal-files.html): Open the file browser, upload and download, create, rename, move and delete items, and edit remote files in the Editor.
- [Forward ports through an SSH session](https://glasspowertools.com/help/terminal-port-forwarding.html): Add local, remote and SOCKS5 port forwards to a live SSH session, start and stop them, and fix common failures.
- [Save and open terminal Workgroups](https://glasspowertools.com/help/terminal-workgroups.html): Create Workgroups of terminal tabs with startup commands, open them on each platform, and swap in SSH for Mac-only local tabs.
- [Terminal settings, themes and snippets](https://glasspowertools.com/help/terminal-settings.html): The Connections, Terminal and Snippets settings pages, resizing and previews, theme editing, a terminal window's own settings, SSH config import and Tailscale.

## Help: Databases

- [Add a database service](https://glasspowertools.com/help/database-add-service.html): Add a MySQL, PostgreSQL or SQLite database to a host, fill in its fields, and make it read-only.
- [Encryption and the SSH tunnel](https://glasspowertools.com/help/database-encryption-and-tunnel.html): Turn on TLS, choose how the certificate is verified, understand the unencrypted warning, and connect through the host's SSH service.
- [The database workspace](https://glasspowertools.com/help/database-workspace.html): Connect, browse databases and schemas, read the overview and charts, use schema commands and the Mutation Log, reconnect, and give a window its own settings.
- [Browse table data](https://glasspowertools.com/help/database-data-grid.html): Switch table views, sort, filter and page rows, manage columns, analyze, follow foreign keys and export.
- [See a database's diagram](https://glasspowertools.com/help/database-schema-diagram.html): Every table, column and foreign key as a live diagram, in three dimensions on Vision Pro.
- [Edit rows and structure](https://glasspowertools.com/help/database-edit-rows.html): Edit, add, delete and paste rows with a review before every write, and change columns, indexes and foreign keys.
- [Write and run SQL](https://glasspowertools.com/help/database-sql-editor.html): Run statements, use Explain Plan, cancel and format, save .sql files, use query history with literal redaction, and keep saved queries.
- [The on-device assistant](https://glasspowertools.com/help/database-on-device-assistant.html): Generate SQL, get suggested fixes and automatic tab titles from the on-device model, and see exactly what it is given.

## Help: Remote desktops

- [Add a remote desktop](https://glasspowertools.com/help/desktop-add-service.html): Add an RDP or VNC Desktop service to a host, what each field means, and how to edit or remove it.
- [Import an RDP file](https://glasspowertools.com/help/desktop-import-rdp-file.html): Turn a .rdp file into a host with a Desktop service, what the import keeps, and which files it refuses.
- [Sign in and trust a remote computer](https://glasspowertools.com/help/desktop-sign-in-and-trust.html): NLA and TLS fallback, VNC password or Mac account sign-in, verifying RDP certificates, and what is not supported.
- [Connect to and leave a remote desktop](https://glasspowertools.com/help/desktop-sessions.html): Open a desktop, enter a password when asked, read status and failures, reconnect, give a desktop window its own settings, and close a session.
- [Remote desktops on Apple Vision Pro](https://glasspowertools.com/help/desktop-vision-pro.html): The desktop window's controls and shape, headset input, glass opacity and strength, and removing the remote background.
- [Resolution, scaling and zoom](https://glasspowertools.com/help/desktop-display-and-scaling.html): Match Window Size, Detail, fixed resolutions, several displays and a window for each, a Mac's displays and pointer, Screen Sharing quality, Retina displays at 1x, a smaller picture from a Mac and what the network carries, High Performance from a Mac, keeping a window in its display's shape, and zooming the image in the window.
- [Keyboard, pointer, clipboard and audio](https://glasspowertools.com/help/desktop-input.html): Typing, the Keys menu and arrow pad, pointer modes and gestures, sharing the clipboard, and remote audio.

## Help: Editor

- [Open the Editor](https://glasspowertools.com/help/editor-opening.html): Ways into the Editor on each platform, what an editor window holds, new documents, and how to leave or close it.
- [Work with Projects](https://glasspowertools.com/help/editor-projects.html): Open folders on this device or on a server as projects, manage the Projects list, and how it syncs between devices.
- [Files, Folders and Tabs](https://glasspowertools.com/help/editor-files-and-tabs.html): Browse a project's files, preview and keep tabs, create new files locally or on a server, and open files on their own.
- [Save Your Work](https://glasspowertools.com/help/editor-saving.html): Save with ⌘S or the toolbar, choose where a new document goes, handle files that changed, and close unsaved documents.
- [Languages, Find and the Status Bar](https://glasspowertools.com/help/editor-languages.html): The 15 highlighted languages and their extensions, changing a file's language, the status bar, Go to Line, and Find and Replace.
- [Preview and Viewers](https://glasspowertools.com/help/editor-preview-and-viewers.html): Preview Markdown with Mermaid diagrams, HTML, SVG and CSV, view images, PDFs, video, audio and 3D models, and what happens with large files.
- [Editor Settings](https://glasspowertools.com/help/editor-settings.html): Text size, line numbers and wrapping at four levels: the Editor's defaults, a window, a project, and a single file; and a window's own glass.