{"id":13503013,"url":"https://github.com/greshake/i3status-rust","last_synced_at":"2025-05-10T03:36:49.981Z","repository":{"id":37267314,"uuid":"88357949","full_name":"greshake/i3status-rust","owner":"greshake","description":"Very resourcefriendly and feature-rich replacement for i3status, written in pure Rust","archived":false,"fork":false,"pushed_at":"2025-05-05T02:28:28.000Z","size":50411,"stargazers_count":2973,"open_issues_count":108,"forks_count":483,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-05-10T03:36:45.019Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/greshake.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2017-04-15T16:01:31.000Z","updated_at":"2025-05-09T16:38:10.000Z","dependencies_parsed_at":"2023-10-03T12:11:05.604Z","dependency_job_id":"c6a4218b-12f2-42bf-95c8-c01160c7ffc9","html_url":"https://github.com/greshake/i3status-rust","commit_stats":{"total_commits":2771,"total_committers":288,"mean_commits":9.621527777777779,"dds":0.8105377120173223,"last_synced_commit":"2c2c19b81ab616cbd93be3f671bb36d06cb7bf2a"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greshake%2Fi3status-rust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greshake%2Fi3status-rust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greshake%2Fi3status-rust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greshake%2Fi3status-rust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/greshake","download_url":"https://codeload.github.com/greshake/i3status-rust/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253358322,"owners_count":21896005,"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":[],"created_at":"2024-07-31T22:02:33.434Z","updated_at":"2025-05-10T03:36:49.922Z","avatar_url":"https://github.com/greshake.png","language":"Rust","funding_links":[],"categories":["Rust","Projects","Status Bars","others","Packages","Tool"],"sub_categories":["Bars, Panels, and Widgets","Desktop Extension Tool"],"readme":"# i3status-rust\n\n![demo1](img/themes/solarized-dark.png)\n\n`i3status-rs` is a feature-rich and resource-friendly replacement for i3status, written in pure Rust. It provides a way to display \"blocks\" of system information (time, battery status, volume, etc) on bars that support the [i3bar protocol](https://i3wm.org/docs/i3bar-protocol.html).\n\n## Getting Started\n\nInstall from one of the packages below:\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/i3status-rust.svg?columns=5\u0026minversion=0.30.0\u0026exclude_unsupported=1)](https://repology.org/project/i3status-rust/versions)\n\n* For Fedora/CentOS, you can install from the [COPR](https://copr.fedorainfracloud.org/coprs/atim/i3status-rust/).\n\n* For NixOS, you can also use [Home Manager](https://github.com/nix-community/home-manager): `programs.i3status-rust.enable = true` [see available options](https://nix-community.github.io/home-manager/options.xhtml#opt-programs.i3status-rust.enable)\n\n* **NOTE:** Installation via `cargo` is not supported.\n\nOtherwise refer to [manual install](doc/manual_install.md) docs.\n\n## Configuration\n\nAfter installing `i3status-rust`, edit the [example configuration](examples/config.toml) to your liking.\nThe default location is `$XDG_CONFIG_HOME/i3status-rust/config.toml`.\n\nThere are some optional global configuration variables, defined either at the top-level or in a [TOML table](https://github.com/toml-lang/toml/blob/main/toml.md#table).\n\n`[icons]` table:\nKey | Description | Default\n----|-------------|----------\n`icons` | The [icon set](doc/themes.md#available-icon-sets) that should be used. | `\"none\"`\n`[icons.icons_overrides]` | Refer to `Themes and Icons` below. | None\n\n`[theme]` table:\nKey | Description | Default\n----|-------------|----------\n`theme` | The [theme](doc/themes.md#available-themes) that should be used. | `\"plain\"`\n`[theme.theme_overrides]` | Refer to `Themes and Icons` below. | None\n\nGlobal variables:\nKey | Description | Default\n----|-------------|----------\n`icons_format` | A string to customise the appearance of each icon. Can be used to edit icons' spacing or specify a font that will be applied only to icons via pango markup. For example, `\" \u003cspan font_family='NotoSans Nerd Font'\u003e{icon}\u003c/span\u003e \"`. | `\" {icon} \"`\n`invert_scrolling` | Whether to invert the direction of scrolling, useful for touchpad users. | `false`\n`error_format` | A string to customise how block errors are displayed. See below for available placeholders. | `\"$short_error_message\\|X\"`\n`error_fullscreen_format` | A string to customise how block errors are displayed when clicked. See below for available placeholders. | `\"$full_error_message\"`\n\nAvailable `error_format` and `error_fullscreen_format` placeholders:\n\nPlaceholder         | Value\n--------------------|------\nfull_error_message  | The full error message\nshort_error_message | The short error message, if available\n\n### Further documentation\n\n#### Latest release\n\n- [Blocks](https://docs.rs/i3status-rs/latest/i3status_rs/blocks/index.html)\n- [Formatting](https://docs.rs/i3status-rs/latest/i3status_rs/formatting/index.html)\n- [Themes and Icons](https://github.com/greshake/i3status-rust/blob/v0.32.0/doc/themes.md)\n- [Geolocator](https://docs.rs/i3status-rs/latest/i3status_rs/geolocator/index.html)\n\n#### Master\n\n- [Blocks](https://greshake.github.io/i3status-rust/i3status_rs/blocks/index.html)\n- [Formatting](https://greshake.github.io/i3status-rust/i3status_rs/formatting/index.html)\n- [Themes and Icons](doc/themes.md)\n- [Geolocator](https://greshake.github.io/i3status-rust/i3status_rs/geolocator/index.html)\n\n## Integrate it into i3/sway\n\nNext, edit your bar configuration to use `i3status-rust`. For example:\n\n```text\nbar {\n    font pango:DejaVu Sans Mono, FontAwesome 12\n    position top\n    status_command path/to/i3status-rs path/to/your/config.toml\n    colors {\n        separator #666666\n        background #222222\n        statusline #dddddd\n        focused_workspace #0088CC #0088CC #ffffff\n        active_workspace #333333 #333333 #ffffff\n        inactive_workspace #333333 #333333 #888888\n        urgent_workspace #2f343a #900000 #ffffff\n    }\n}\n```\n\nIn order to use the built-in support for the Font Awesome icon set, you will need to include it in the `font` parameter, as above. Check to make sure that \"FontAwesome\" will correctly identify the font by using `fc-match`, e.g.\n\n```shell\n$ fc-match FontAwesome\nfontawesome-webfont.ttf: \"FontAwesome\" \"Regular\"\n```\n\nNote that the name of the Font Awesome font may have changed in version 5 or above.  \nYou can use `fc-list` to see the names of your available Awesome Fonts.\n\n```shell\n$ fc-list | grep -i awesome\n/usr/share/fonts/TTF/fa-solid-900.ttf: Font Awesome 5 Free,Font Awesome 5 Free Solid:style=Solid\n/usr/share/fonts/TTF/fa-regular-400.ttf: Font Awesome 5 Free,Font Awesome 5 Free Regular:style=Regular\n```\n\nIn this example, you have to use `Font Awesome 5 Free` instead of the `FontAwesome 12` in the example configuration above.\nYou can verify the name again using `fc-match`\n\nSee [#130](https://github.com/greshake/i3status-rust/issues/130) for further discussion.\n\nFinally, reload i3: `i3 reload`.\n\n## Behavior\n\nEach block has a `State` that defines its colors: one of \"Idle\", \"Info\", \"Good\", \"Warning\", \"Critical\" or \"Error\". The state is determined by the logic in each block, for example, the Music block state is \"Info\" when there is an active player.\n\nWhen the state is \"Error\", a short error will be displayed in the block. The full message can be toggled by clicking on the block (overrides any click actions defined in the config). The block will be restarted after `error_interval` has elapsed.\n\ni3bar has a \"power savings\" feature that pauses the bar via SIGSTOP when it is hidden or obscured by a fullscreen container. If this causes [issues](https://github.com/i3/i3/issues/4110) with your bar, try running i3status-rs with the `--never-stop` argument, which changes the signal sent by i3 from SIGSTOP to SIGCONT.\n\nIn addition to the per-block `signal` config option, i3status-rs can be signalled to force an update of all blocks by sending it the SIGUSR1 signal. It can also be restarted in place (useful for testing changes to the config file) by sending it the SIGUSR2 signal.\n\n## Debugging\n\nRun `i3status-rust` in a terminal to check the JSON it is outputting.  \nIn addition, some blocks have debug logs that can be enabled like so: `RUST_LOG=block=debug i3status-rs` where \"block\" is the block name.\n\n## Contributing\n\nWe welcome new contributors! Take a gander at [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the GPLv3. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreshake%2Fi3status-rust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreshake%2Fi3status-rust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreshake%2Fi3status-rust/lists"}