https://github.com/danirod/cartero
Cartero is the native, lightweight, multiplatform and free HTTP client that you can use to test your APIs. Avoid bloat, respect your privacy, reject cloud; that's the motto.
https://github.com/danirod/cartero
adwaita curl gnome gtk-rs gtk4 http-client libadwaita rust
Last synced: 9 months ago
JSON representation
Cartero is the native, lightweight, multiplatform and free HTTP client that you can use to test your APIs. Avoid bloat, respect your privacy, reject cloud; that's the motto.
- Host: GitHub
- URL: https://github.com/danirod/cartero
- Owner: danirod
- License: gpl-3.0
- Created: 2024-03-22T21:37:46.000Z (almost 2 years ago)
- Default Branch: trunk
- Last Pushed: 2025-04-25T23:08:50.000Z (10 months ago)
- Last Synced: 2025-04-26T00:18:57.412Z (10 months ago)
- Topics: adwaita, curl, gnome, gtk-rs, gtk4, http-client, libadwaita, rust
- Language: Rust
- Homepage: https://cartero.danirod.es
- Size: 7.15 MB
- Stars: 662
- Watchers: 8
- Forks: 44
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
Cartero is a graphical HTTP client that can be used as a developer tool to
test web APIs and perform all kind of HTTP requests to web servers. It is
compatible with any REST, SOAP or XML-RPC API and it supports multiple request
methods as well as attaching body payloads to compatible requests.
**Features:**
- Loads and saves to plain Git-friendly TOML files, so that you can own your data.
- Customization and modification of the request headers and body payloads.
- Variable binding for API keys and other secret information.
**Motivation:**
This project exists because there aren't many native graphical HTTP testing
applications / graphical alternatives to cURL that are fully free software, and
I think the world has had enough of Electron / non-native applications that are
anonymously accesible until one day you are forced to create an account and
log in to use just to make some investor happy with their numbers or to chug
some unwanted artificial intelligence at users.
## Download
All the downloads for GNU/Linux, Windows and macOS are collected in the
**[Download page][downloads]**. You can also
find the download links for the latest version in the **[GitHub page][ghrel]**.
### Get it from Flathub
### Get it from Snap Store
### Get it from your package manager
> **Note**: distributions in package managers are maintained by the community.
Cartero as a project is open to help and communicate with the maintainers of
those ports, but outdated versions and other packaging issues should be
reported first to the package manager or to the port maintainer, not here.
[](https://repology.org/project/cartero/versions)
**macOS**: You can also get it from Homebrew [using the tap][homebrew]:
```bash
brew tap SoloAntonio/cartero
brew install --cask cartero
```
**Windows**: Also is available using [Scoop][scoop] (command-line installer for Windows):
```bash
scoop bucket add extras
scoop install extras/cartero
```
**NixOS**: You can also add Cartero to your system [as a flake][flake].
## Building
Currently, to build the application you'll have to make sure that the required
libraries are installed on your system.
- glib >= 2.72
- gtk >= 4.14
- gtksourceview >= 5.4
- libadwaita >= 1.5
- openssl >= 1.0
For a successful build, will also need the following packages installed in your system: **meson**, **ninja**, **rust** and **gettext**.
Then use the following commands to build and install the application
```sh
meson setup build
ninja -C build
ninja -C build install
```
To avoid installing system-wide the application, you can use a prefix:
```sh
meson setup build --prefix=/usr
ninja -C build
ninja -C build install
```
## Hacking and contributing
**If you plan on contributing to the project**, use the development profile.
It will also configure a Git hook so that the source code is checked prior to
authoring a Git commit. The hook runs `cargo fmt` to assert that the code is
formatted. Read `hooks/pre-commit.hook` to inspect what the script does.
```sh
meson setup build -Dprofile=development
```
If you want to hack the source code and make your own changes to Cartero, you
can do it as long as you know enough Rust and enough about GTK and the rest of the
libraries it uses. Check out the [hacking instructions][hacking].
It provides instructions useful for those who want to compile, test and run the
application, specifically how to compile the resource bundles and run the application.
If you want to share your changes with the world, you could send a pull request to
add the code to Cartero so that anyone can benefit from it. Information on how to
contribute has moved to [the website][contributing].
**Usage of generative AI is prohibited**. Therefore, please avoid submitting a pull
request if your contribution has been generated by an LLM tool and you're just copying
verbatim the output it generated. Check [the appropiate section][genai] for more
information on that.
**Other ways to contribute to Cartero also include reporting bugs, sending feedback,
talking about Cartero to other people to make the project more popular, and sending
translations**. We are using [Weblate][weblate] to coordinate and translate comfortably
this project using a web interface. Make an account and start proposing strings and they
will be added to the application. That will also entitle you as a contributor!
## Licenses
Cartero is published under the terms of the GNU General Public License v3.0 or later.
```
Copyright 2024-2025 the Cartero authors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
```
The Cartero icon is published under the a [Creative Commons
Attribution-ShareAlike 4.0 International license][ccbysa].
## Credits and acknowledgments
Cartero is maintained by Dani Rodríguez.
Big shoutout to the [contributors][contrib] who have sent patches or
translations! Also, Christian suggested Cartero as the name for the
application and I liked it enough to call it like so, therefore shoutout
to Christian as well!
[ccbysa]: https://creativecommons.org/licenses/by-sa/4.0/
[contrib]: https://github.com/danirod/cartero/graphs/contributors
[weblate]: https://hosted.weblate.org/projects/cartero/
[homebrew]: https://cartero.danirod.es/docs/installing/macos-brew.html
[flake]: https://cartero.danirod.es/docs/installing/nixos-flake.html
[hacking]: https://cartero.danirod.es/docs/hacking.html
[contributing]: https://cartero.danirod.es/docs/contributing.html
[scoop]: https://scoop.sh/
[genai]: https://cartero.danirod.es/docs/contributing.html#use-of-generative-ai
[downloads]: https://cartero.danirod.es/download.html
[ghrel]: https://github.com/danirod/cartero/releases/latest