Getting Started

Getting Started

This page gets you from zero to your first response.

1. Install

Getman ships as a native binary per platform. Grab the latest from the Releases page.

Platform	File	How to install
macOS (Apple Silicon)	getman-vX.Y.Z-macos-arm64.zip	Unzip, drag getman.app into /Applications.
Windows (x64)	getman-vX.Y.Z-windows-x64.zip	Unzip the whole folder anywhere, run getman.exe.
Linux (x64)	getman-vX.Y.Z-linux-x64.tar.gz	tar -xzf getman-*.tar.gz && ./getman
Web	—	Use the live demo (note browser [[FAQ and Troubleshooting

First-launch security warnings

The released binaries aren't code-signed yet, so the OS warns on first launch:

• macOS: right-click getman.app → Open → confirm. (Or run xattr -dr com.apple.quarantine /Applications/getman.app.)
• Windows: click More info → Run anyway on the SmartScreen prompt.

This is a one-time step per install. See FAQ and Troubleshooting for details.

Prefer to build it yourself? See Building from Source.

2. Send your first request

1. Getman opens with one empty request tab.
2. The method dropdown defaults to GET. Leave it.
3. Click the URL field and type a URL, e.g. https://httpbin.org/get.
4. Press Cmd/Ctrl + Enter (or click SEND).
5. The response appears — status code, time, and size at the top, body below.

That's it. No project setup, no account.

3. Try the essentials

• Add query params — open the PARAMS tab and add a key/value; it's written into the URL automatically (and vice-versa).
• POST some JSON — switch the method to POST, open the BODY tab, pick RAW, type JSON, and press Cmd/Ctrl + B to beautify it.
• Paste a cURL command — copy any curl ... command and paste it straight into the URL field; Getman parses the method, URL, headers, and body for you. See Building Requests.
• Save it — press Cmd/Ctrl + S to save the request into a Collections.
• Reuse values — define an Environments and Variables and reference {{variables}} anywhere.

4. Learn the layout

Head to The Interface for a tour of the panels, tabs, side menu, and how the UI adapts from desktop to phone widths.

Where your data lives

Everything you do is saved locally and instantly (tabs are debounced; collections/settings/environments save immediately). Nothing is uploaded. See Data Privacy and Storage.