{"id":15721999,"url":"https://github.com/j-lentz/iwgtk","last_synced_at":"2025-04-12T18:48:33.764Z","repository":{"id":39669585,"uuid":"287169501","full_name":"J-Lentz/iwgtk","owner":"J-Lentz","description":"Lightweight wireless networking GUI (front-end for iwd)","archived":false,"fork":false,"pushed_at":"2025-01-21T14:27:08.000Z","size":779,"stargazers_count":239,"open_issues_count":13,"forks_count":18,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-03T22:08:00.624Z","etag":null,"topics":["gtk4","iwd","linux","wifi"],"latest_commit_sha":null,"homepage":"","language":"C","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/J-Lentz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"COPYING","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":"2020-08-13T03:13:29.000Z","updated_at":"2025-03-29T18:00:25.000Z","dependencies_parsed_at":"2025-02-05T04:35:28.712Z","dependency_job_id":null,"html_url":"https://github.com/J-Lentz/iwgtk","commit_stats":{"total_commits":153,"total_committers":12,"mean_commits":12.75,"dds":0.2875816993464052,"last_synced_commit":"2d72e8ae4cf24426ed62bf7f4d6366ed06d4c99d"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/J-Lentz%2Fiwgtk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/J-Lentz%2Fiwgtk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/J-Lentz%2Fiwgtk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/J-Lentz%2Fiwgtk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/J-Lentz","download_url":"https://codeload.github.com/J-Lentz/iwgtk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618214,"owners_count":21134199,"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":["gtk4","iwd","linux","wifi"],"created_at":"2024-10-03T22:02:36.895Z","updated_at":"2025-04-12T18:48:33.727Z","avatar_url":"https://github.com/J-Lentz.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"## About\niwgtk is a wireless networking GUI for Linux. It is a front-end for [iwd (iNet\nWireless Daemon)](https://iwd.wiki.kernel.org/), with supported functionality\nsimilar to that of iwctl. Features include viewing and connecting to available\nnetworks, managing known networks, provisioning new networks via WPS or Wi-Fi\nEasy Connect, and an indicator (tray) icon displaying connection status and\nsignal strength.\n\n![Screenshot](screenshot/iwgtk-station-mode.png)\n\n## Usage\nLaunch the application window: `iwgtk`\n\nLaunch the indicator daemon: `iwgtk -i`\n\n### Autostarting\nThe most common use case for iwgtk is to start the indicator daemon every time\nyou log into your desktop. If your desktop environment supports the XDG\nautostart standard, this should happen automatically due to the\n`iwgtk-indicator.desktop` file which is placed in `/etc/xdg/autostart/` during\ninstallation.\n\nA systemd unit file to start the indicator daemon is also provided. If your\ndistro uses systemd and your desktop environment supports systemd's\n`graphical-session.target` unit, then iwgtk can be started at the beginning of\nevery desktop session by enabling the `iwgtk.service` unit.\n\n### Configuration\nIcon colors and other options can be customized by editing the application's\nconfiguration file. The system-wide configuration file is located at\n`$(sysconfdir)/iwgtk.conf`. `$(sysconfdir)` is usually either `/etc` or\n`/usr/local/etc`, depending on your build-time `prefix` setting. `iwgtk.conf`\ncan be copied to `~/.config/iwgtk.conf` if desired, in which case the\nsystem-wide configuration file will be ignored. For further instructions, please\nsee `man 5 iwgtk` and refer to the comments in `iwgtk.conf`.\n\n## Dependencies\n\n### Runtime dependencies\n* iwd (\u003e= 1.29)\n* gtk4 (\u003e= 4.12)\n* libqrencode\n* adwaita-icon-theme (or an equivalent icon package)\n\n### Build dependencies\n* meson (\u003e= 0.60.0)\n* scdoc\n\n## Installation\nTo build iwgtk and install to `/usr/local`, run:\n```\nmeson setup build\ncd build\nmeson compile\nsudo meson install\n```\n\nTo install to `/usr` instead of `/usr/local`, replace `meson setup build` with:\n```\nmeson setup --prefix=/usr build\n```\n\n## Troubleshooting\n\n### The indicator icon doesn't show up\niwgtk's icon should show up on any system tray which supports the\nStatusNotifierItem API. If your tray only supports the older XEmbed API, then a\ncompatibility layer such as [snixembed](https://git.sr.ht/~steef/snixembed) is\nrequired.\n\nThe following trays support StatusNotifierItem:\n* KDE Plasma\n* swaybar\n* xfce4-panel (*must be built with the optional libdbusmenu-gtk3 dependency*)\n\nThe following trays only support XEmbed, and require a compatibility layer:\n* AwesomeWM\n* i3bar\n\n### iwgtk and iwctl only work with superuser privileges\nAs of iwd 1.23, membership in either the `netdev` or `wheel` group is required\nto control iwd:\n```\n# usermod -a -G netdev YOUR_USER_ACCOUNT\n```\nIf no `netdev` group exists on your system, then you'll need to create it prior\nto running the above `usermod` command:\n```\n# groupadd netdev\n```\n\n## License\nCopyright 2020-2025 Jesse Lentz \u003cjesse@twosheds.org\u003e and contributors (see below)\n\niwgtk is licensed under the GPL version 3 or later.\n\nThe application icon is from the [wifi\nstates](https://thenounproject.com/iconsguru/collection/wifi-states/) collection\nby [i cons](https://thenounproject.com/iconsguru/) from the Noun Project. This\nicon is licensed under the [Creative Commons BY\nlicense](https://creativecommons.org/licenses/by/3.0/us/legalcode).\n\n## Contributors\n* Jove Yu\n* Jaron Viëtor (Thulinma)\n* tinywrkb\n* Érico Nogueira Rolim\n* VaguePenguin\n* Andrew Benson\n* Alex Piechowski (grepsedawk)\n* Luigi Baldoni\n* Integral-Tech\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj-lentz%2Fiwgtk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj-lentz%2Fiwgtk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj-lentz%2Fiwgtk/lists"}