What’s new in HTTPie for Terminal 3.2
Published: 2022-05-17 13:50:47

---
description: Refined UI, man pages, single binary executables, Debian releases, and more.
---

HTTPie has always been about making interaction with APIs as human-friendly as possible. Part of that is ensuring our apps are ubiquitous and up-to-date. This release of HTTPie for Terminal brings many improvements in all these areas.

Check out what’s new 👇

## Summary

**🤩 [Refined UI](#refined-ui) —** Improved user experience and usability.

**📖 [Man pages](#man-pages) —** HTTPie is finally getting complete manuals available through `man httpie`, `man http`, and `man https`.

**📦 [Single binary executables](#single-binary-executables) —** download HTTPie as a single binary file and run it without installation.

**🌀 [Debian releases](#debian-releases) —** most recent releases will now be offered also through our custom Apt repo with new releases instantly available for Debian, Ubuntu, etc.

**⬆️ [Update warnings](#update-warnings) —** get notified about new versions as soon as they become available for your system straight in the terminal.

**⚖️ [Improved persistence for headers](#improved-persistence-for-headers) —** multiple headers with the same name are persisted in the sessions.

**🪲 [Bug fixes](#bug-fixes) —** multiple headers with the same name are persisted in the sessions.

**♥️ [Community contributions](#community-contributions) —** lots of amazing people who have contributed to this release.

## 🤩 Refined UI

This release brings various UI and UX improvements. For example, here is HTTPie’s new progress bar:

![New Style Progress Bars](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/wbwksh82b4njhbcdts9c.gif)

Even though our original progress bar implementation was [simple and elegant](https://codecatalog.org/articles/httpie-status-reporting/), we’ve decided to adopt the powerful [Rich](https://github.com/Textualize/rich) library for various parts of the UI.

By the way, the example above uses the recently-added `--style=pie-dark` style. We highly recommend making it your default style for the best experience and consistency with [HTTPie for Web & Desktop](https://httpie.io/product).

📖 [Colors & formatting docs →](https://httpie.io/docs/cli/colors-and-formatting)

## 📖 Man Pages

The long-awaited man pages are here now. You can use `man http` or `man https` to have the full man page experience with colors and pager:

```bash-termible
$ man http
```

We have also introduced a shorthand for this operation, `http --manual`:

```bash-termible
$ http --manual
```

When the man pages are available (installed by your platform’s packager), it will automatically open you the HTTPie’s manual. When they are not, this command will open the regular manual but inside of a pager.

The `httpie` management command now has a man page as well:

```bash-termible
$ man httpie
```


📖 [Help & manual docs →](https://httpie.io/docs/cli/usage)

## 📦 Single binary executables

For Linux systems, we now offer single binary executables which you can download and start using without installation. The new asset named `http` now included in every [release of HTTPie on GitHub](https://github.com/httpie/httpie/releases/latest) is all you need:

```bash-termible
$ https -do http_standalone github.com/httpie/httpie/releases/download/3.2.1/http
```


```bash-termible
$ chmod +x ./http_standalone
```

```bash-termible
$ ./http_standalone --version
```

📖 [Single binary installation docs →](https://httpie.io/docs/cli/single-binary-executables)

## 🌀 Debian releases

We now host our own Debian Apt repository to provide instant updates with new features to users of Debian, Ubuntu, and other derived distros:

```bash
$ curl -SsL https://packages.httpie.io/deb/KEY.gpg | apt-key add -
$ curl -SsL -o /etc/apt/sources.list.d/httpie.list https://packages.httpie.io/deb/httpie.list
$ apt update
$ apt install httpie
```

📖 [Debian & Ubuntu installation docs →](https://httpie.io/docs/cli/debian-and-ubuntu)

## ⬆️ Update warnings

HTTPie for Terminal is now part of a broader platform, and we iterate quickly and deliver new features frequently. To keep existing users up-to-date, this version adds a gentle new warning:

```bash
$ http pie.dev/get
http: info: A new HTTPie release (3.3.0) is available.
To see how you can update, please visit https://httpie.io/docs/cli/pypi

HTTP/1.1 200 OK
Content-Encoding: gzip
Content-Type: application/json

{
    "args": {},
    "headers": {
        "Accept": "*/*",
        "Accept-Encoding": "gzip",
        "Cdn-Loop": "cloudflare",
    },
    "url": "http://pie.dev/get"
}

```

You can also check the latest release by manually running `check-updates`:

```bash-termible
$ httpie cli check-updates
```

📖 [Update warning docs →](https://httpie.io/docs/cli/update-warnings)

## ⚖️ Improved persistence for headers

Multiple headers with the same name are now correctly persisted inside sessions. E.g.:

```bash-termible
$ http --session test pie.dev/headers X-Foo:bar X-Foo:baz
```

```bash-termible
$ http --session test pie.dev/headers
```

For upgrading your old sessions, you can use `httpie cli sessions upgrade`:

```bash-termible
$ httpie cli sessions upgrade pie.dev test
```

To upgrade all named sessions in one go, you can try `httpie cli sessions upgrade-all`.

```bash-termible
$ httpie cli sessions upgrade-all
```

📖 [Session upgrade docs →](https://httpie.io/docs/cli/upgrading-sessions)

## ✨ Other improvements

Moved `httpie plugins *` command to the new `httpie cli plugins` namespace. This provides a more scalable namespacing of the management subcommands. The original `httpie plugins *` commands are now hidden aliases.

## 🪲 Bug fixes

- Removed the redundant addition of `Content-Length: 0` header to body-less `OPTIONS` requests.
- The thread observing standard input to provide a warning when no data arrives is now properly terminated when HTTPie itself exists.

🐙 [Full changelog →](https://github.com/httpie/httpie/blob/master/CHANGELOG.md#320-2022-05-05)

## ♥️ Community contributions

Last but not least, we’d like to thank the amazing people who’ve contributed to this release of HTTPie: [Ethan Mills](https://github.com/ethanmills), [Jan Verbeek](https://github.com/blyxxyz), [Mohamed Daahir](https://github.com/ducaale), [Nicklas Ansman Giertz](https://github.com/ansman),  [Oliver Fish](https://github.com/Oliver-Fish), [Roberto López López](https://github.com/robertolopezlopez), [luzpaz](https://github.com/luzpaz), and [zhaohanqing95](https://github.com/zhaohanqing95).

🐙 [How to contribute →](https://github.com/httpie/httpie/blob/master/CONTRIBUTING.md)