{"id":13709942,"url":"https://github.com/Arnau478/hevi","last_synced_at":"2025-05-06T18:33:30.334Z","repository":{"id":195027942,"uuid":"692093066","full_name":"Arnau478/hevi","owner":"Arnau478","description":"Hex viewer","archived":false,"fork":false,"pushed_at":"2024-10-19T16:44:42.000Z","size":994,"stargazers_count":76,"open_issues_count":6,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-13T00:03:20.907Z","etag":null,"topics":["binary","hex","hex-viewer","zig","zig-package"],"latest_commit_sha":null,"homepage":"https://arnau478.github.io/hevi/","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Arnau478.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-15T14:41:34.000Z","updated_at":"2024-11-12T02:29:42.000Z","dependencies_parsed_at":"2024-06-28T18:42:46.572Z","dependency_job_id":"24a9523a-19e0-4287-a771-f913272ce898","html_url":"https://github.com/Arnau478/hevi","commit_stats":null,"previous_names":["arnau478/hevi"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arnau478%2Fhevi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arnau478%2Fhevi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arnau478%2Fhevi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arnau478%2Fhevi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Arnau478","download_url":"https://codeload.github.com/Arnau478/hevi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224521482,"owners_count":17325244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binary","hex","hex-viewer","zig","zig-package"],"created_at":"2024-08-02T23:00:48.984Z","updated_at":"2025-05-06T18:33:30.321Z","avatar_url":"https://github.com/Arnau478.png","language":"Zig","funding_links":[],"categories":["Fundamentals"],"sub_categories":["Utility"],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ch1 align=\"center\"\u003ehevi\u003c/h1\u003e\n    \u003ch3\u003ea hex viewer\u003c/h3\u003e\n\u003c/div\u003e\n\n![ci status](https://github.com/Arnau478/hevi/actions/workflows/ci.yml/badge.svg)\n\n![example image](web/example.png)\n\n## What is hevi?\nHevi (pronounced like \"heavy\") is a hex viewer, just like `xxd` or `hexdump`.\n\n## Features\n### Parsers\nHevi can parse things like ELF or PE files and give you syntax-highlighting.\n![parser example](web/parser.png)\n\n### Custom color palettes\nYou can specify custom color palettes. Color palettes can use standard ANSI colors or truecolor.\n\n## Usage\nThe command should be used as `hevi \u003cfile\u003e [flags]`. The flags are described [below](#flags).\n\n### Flags\n| Flag(s)                          | Description                                             |\n| -------------------------------- | ------------------------------------------------------- |\n| `-h`/`--help`                    | Show a help message                                     |\n| `-v`/`--version`                 | Show version information                                |\n| `--color`/`--no-color`           | Enable or disable colored output                        |\n| `--lowercase`/`--uppercase`      | Toggle between lowercase and uppercase hex              |\n| `--size`/`--no-size`             | Enable or disable the line showing the size at the end  |\n| `--offset`/`--no-offset`         | Enable or disable showing the offset                    |\n| `--ascii`/`--no-ascii`           | Enable or disable ASCII interpretation                  |\n| `--skip-lines`/`--no-skip-lines` | Enable or disable skipping of identical lines           |\n| `--raw`                          | Raw format (disables most features)                     |\n| `--show-palette`                 | Show the current color palette in a table               |\n| `--parser`                       | Specify the parser to use. For a list use `hevi --help` |\n\n### Environment variables\nThe `NO_COLOR` variable is supported, and disables color (see \u003chttps://no-color.org/\u003e) printing. Note that it can be overwritten by an explicit `--color`.\n\n### Config file\nThe config file is a [ziggy](https://ziggy-lang.io) file. The following fields are available:\n```zig\ncolor: bool,\nuppercase: bool,\nshow_size: bool,\nshow_offset: bool,\nshow_ascii: bool,\nskip_lines: bool,\nraw: bool,\npalette: Palette,\n```\n\nAll fields are optional.\n\n**Note**: for the `palette` field you must specify all styles!\n\n#### Example config\n```zig\n.color = true,\n.skip_lines = false,\n.palette = Palette{\n    .normal = @color(\"yellow\"),\n    .normal_alt = @color(\"yellow::dim\"),\n    .normal_accent = @color(\"yellow:bright_black:bold\"),\n    .c1 = @color(\"red\"),\n    .c1_alt = @color(\"red::dim\"),\n    .c1_accent = @color(\"red:bright_black:bold\"),\n    .c2 = @color(\"green\"),\n    .c2_alt = @color(\"green::dim\"),\n    .c2_accent = @color(\"green:bright_black:bold\"),\n    .c3 = @color(\"blue\"),\n    .c3_alt = @color(\"blue::dim\"),\n    .c3_accent = @color(\"blue:bright_black:bold\"),\n    .c4 = @color(\"cyan\"),\n    .c4_alt = @color(\"cyan::dim\"),\n    .c4_accent = @color(\"cyan:bright_black:bold\"),\n    .c5 = @color(\"magenta\"),\n    .c5_alt = @color(\"magenta::dim\"),\n    .c5_accent = @color(\"magenta:bright_black:bold\"),\n},\n```\n\n#### Location\n\nThe config file is located at:\n| OS                                     | Path                                                                                             |\n| -------------------------------------- | ------------------------------------------------------------------------------------------------ |\n| Linux, MacOS, FreeBSD, OpenBSD, NetBSD | `$XDG_CONFIG_HOME/hevi/config.ziggy` or if the env doesn't exist `$HOME/.config/hevi/config.ziggy` |\n| Windows                                | `%APPDATA%/hevi/config.ziggy`                                                                     |\n| Other                                  | Not supported. No config file will be read                                                       |\n\n#### Precedence\nHevi has a precedence for configuration and it is:\n1. Flags\n2. Environment variables\n3. Config file\n4. Defaults\n\n## About\nIt is written in [zig](https://github.com/ziglang/zig), in an attempt to simplify hex viewers.\n\n## Installation\n\n### Some Linux package managers\nIf your package manager is in the following list (and preferably in green), you can simply install it from there:\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/hevi.svg)](https://repology.org/project/hevi/versions)\n\n### Homebrew\n\nYou can install [hevi](https://formulae.brew.sh/formula/hevi) with [brew](https://brew.sh/):\n\n```sh\n$ brew install hevi\n```\n\n### Nix\nThere is a nix flake you can use. You can also try hevi without installing it:\n\n```sh\n$ nix shell github:Arnau478/hevi\n```\n\n### Other platforms\nYou can download a binary from the [releases](https://github.com/Arnau478/hevi/releases/) page. You can also clone the repository and compile it with `zig build`.\n\n## Contribute\nContributions are welcome! Even if you don't want to write code, you can help a lot creating new issues or testing this software.\n\n## License\nSee [LICENSE](LICENSE)\n\nSPDX-License-Identifier: GPL-3.0-or-later\n\n[![License: GPL-3.0-or-later](https://img.shields.io/badge/License-GPL--3.0--or--later-blue.svg)](https://spdx.org/licenses/GPL-3.0-or-later.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FArnau478%2Fhevi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FArnau478%2Fhevi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FArnau478%2Fhevi/lists"}