Frequently Asked Questions

Using Posting

How do I edit headers or query parameters?

Edit them in place: move to the row with the arrow keys (or click it) and type. Type into the empty row at the bottom of a table to add a row, press Ctrl+X to delete one, and Ctrl+R to enable or disable one. See Requests.

Can I use Posting 3 and Posting 2 on the same collection?

You can share ordinary HTTP requests that don't use Posting 3 fields. Edit GraphQL, gRPC, and requests with scoped variables only in Posting 3. Saving them in Posting 2 removes the fields that store their queries, RPC settings, or scoped variables.

Both versions read the same config file and .env files, but some settings behave differently. Scripts are preserved but aren't run in Posting 3, and each version has separate history. See Coming from Posting 2 for the compatibility limits.

Does Posting 3 run my Posting 2 scripts?

Not yet. Requests with scripts still open and send, and the scripts are kept when you save, but they aren't run. See Scripting.

Why does a key combination do nothing?

Your terminal, multiplexer (such as tmux) or operating system may be using it, or may not be able to send it. Ctrl+H in particular is sent as Backspace by many terminals. You can choose different keys in your keymap, and most things are also in the command palette (Ctrl+P).

Why don't icons show up?

Posting only draws icons when it knows a Nerd Font is available. If you use one, set nerd_fonts: true in your configuration.

Where does Posting keep its files?

Run posting locate config, posting locate collection or posting locate themes to find the config file, the default collection and the themes directory. History and remembered environments are kept in ~/.local/share/posting/ (or $XDG_DATA_HOME/posting/).

Contributing

How do I suggest a feature?

You can suggest a feature by opening a Discussion on the GitHub repository under the "Ideas" category.

How do I report a bug?

You can report a bug by opening an Issue on the GitHub repository.

How do I contribute code to Posting?

You can contribute code to Posting by opening a Pull Request on the GitHub repository.

However, reporting bugs and suggesting features is also a great way to contribute!

General

How was Posting built?

Posting 3 is written in Go, using Terma, a library for building terminal user interfaces. Posting 2 was built in Python with Textual.

Who is the original creator of Posting?

Posting was originally created by Darren Burns, an open-source developer from Scotland, UK.