{"id":17694759,"url":"https://github.com/avojak/iridium","last_synced_at":"2025-04-27T06:53:31.195Z","repository":{"id":45232919,"uuid":"184354930","full_name":"avojak/iridium","owner":"avojak","description":"Native Linux IRC client built in Vala and Gtk for elementary OS","archived":false,"fork":false,"pushed_at":"2023-03-12T01:25:07.000Z","size":5059,"stargazers_count":55,"open_issues_count":29,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-27T06:53:26.082Z","etag":null,"topics":["elementary-os","gtk","gtk3","irc","irc-client","linux","vala","vala-applications"],"latest_commit_sha":null,"homepage":"","language":"Vala","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/avojak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"avojak","issuehunt":null,"otechie":null,"custom":["https://cash.app/$avojak","https://venmo.com/avojak","https://www.paypal.me/avojak"]}},"created_at":"2019-05-01T01:35:52.000Z","updated_at":"2024-12-25T14:53:09.000Z","dependencies_parsed_at":"2024-10-24T16:49:08.189Z","dependency_job_id":"d3cc9d26-a51b-4003-9204-0d104c25cee5","html_url":"https://github.com/avojak/iridium","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avojak%2Firidium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avojak%2Firidium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avojak%2Firidium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avojak%2Firidium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avojak","download_url":"https://codeload.github.com/avojak/iridium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251099748,"owners_count":21536155,"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":["elementary-os","gtk","gtk3","irc","irc-client","linux","vala","vala-applications"],"created_at":"2024-10-24T13:49:37.727Z","updated_at":"2025-04-27T06:53:31.176Z","avatar_url":"https://github.com/avojak.png","language":"Vala","readme":"![CI](https://github.com/avojak/iridium/workflows/CI/badge.svg)\n![Lint](https://github.com/avojak/iridium/workflows/Lint/badge.svg)\n![GitHub](https://img.shields.io/github/license/avojak/iridium.svg?color=blue)\n![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/avojak/iridium?sort=semver)\n[![Mentioned in Awesome IRC](https://awesome.re/mentioned-badge.svg)](https://github.com/davisonio/awesome-irc)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"data/assets/iridium.svg\" alt=\"Icon\" /\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eIridium\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://appcenter.elementary.io/com.github.avojak.iridium\"\u003e\u003cimg src=\"https://appcenter.elementary.io/badge.svg\" alt=\"Get it on AppCenter\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n| ![Screenshot](data/assets/screenshots/iridium-screenshot-01.png) | ![Screenshot](data/assets/screenshots/iridium-screenshot-02.png) |\n|------------------------------------------------------------------|------------------------------------------------------------------|\n| ![Screenshot](data/assets/screenshots/iridium-screenshot-03.png) | ![Screenshot](data/assets/screenshots/iridium-screenshot-04.png) |\n\n## The friendly IRC client\n\nIridium is a native Linux IRC client built in Vala and Gtk for [elementary OS](https://elementary.io).\n\n## Install from Source\n\nYou can install Iridium by compiling from source. Here's the list of\ndependencies required:\n\n- `granite (\u003e= 0.6.0)`\n- `debhelper (\u003e= 10.5.1)`\n- `gettext`\n- `libgtk-3-dev (\u003e= 3.10)`\n- `libgee-0.8-dev`\n- `libsecret-1-dev`\n- `libsqlite3-dev`\n- `meson`\n- `valac (\u003e= 0.28.0)`\n- `libsqlite3-dev`\n- `libgtksourceview-4-dev`\n- `libhandy-1-dev (\u003e=1.0.0)`\n\nAn `install-dev-dependencies.sh` script is available to help developers get up and running.\n\n## Building and Running\n\n```bash\n$ meson build --prefix=/usr\n$ sudo ninja -C build install\n$ com.github.avojak.iridium\n```\n\n### Flatpak\n\nTo test the Flatpak build with Flatpak Builder:\n\n```bash\n$ flatpak-builder build com.github.avojak.iridium.yml --user --install --force-clean\n$ flatpak run --env=G_MESSAGES_DEBUG=all com.github.avojak.iridium\n```\n\nAnother helpful environment variable to set is `GTK_DEBUG=interactive` for investigating UI and styling issues.\n\n### Development Build\n\nYou can also install a development build alongside a stable version by specifying the dev profile:\n\n```bash\n$ meson build --prefix=/usr -Dprofile=dev\n$ sudo ninja -C build install\n$ G_MESSAGES_DEBUG=all com.github.avojak.iridium-dev\n```\n\n### Updating Translations\n\nWhen new translatable strings are added, ensure that `po/POTFILES` contains a\nreference to the file with the translatable string.\n\nUpdate the `.pot` file which contains the translatable strings:\n\n```bash\n$ ninja -C build com.github.avojak.iridium-pot\n```\n\nGenerate translations for the languages listed in the `po/LINGUAS` files:\n\n```bash\n$ ninja -C build com.github.avojak.iridium-update-po\n```\n\n### Testing\n\nTo facilitate testing, a `test-server.py` script is available which starts a local IRC server using Docker.\n\n```bash\n$ ./test-server.py [-h] {create|start|watch|stop|reset}\n```\n\nTo create a new test server:\n\n```bash\n$ ./test-server.py create\n```\n\nYou should now be able to connect to the server from Iridium using the Server `localhost`, and all other settings as default. (Note: If you have configured the settings to reject unacceptable SSL/TLS certificates, you may not be able to connect because the Docker IRC server uses self-signed certificates)\n\n### Troubleshooting and Debugging\n\n#### Logging\n\nLog messages can be found using the `journalctl` command. For example, the following will show journal messages for the current boot of the OS:\n\n```bash\n$ journalctl -b\n```\n\nWhen the application starts, it logs a series of messages with basic information:\n\n```\nJan 01 11:13:24 avojak-eOS plank.desktop[1992]: [INFO 11:13:24.802632] Application.vala:48: com.github.avojak.iridium-dev version: 1.0.0\nJan 01 11:13:24 avojak-eOS plank.desktop[1992]: [INFO 11:13:24.802666] Application.vala:49: Kernel version: 5.4.0-58-generic\nJan 01 11:13:24 avojak-eOS plank.desktop[1992]: [INFO 11:13:24.815561] SecretManager.vala:46: Secret schema version: 1\nJan 01 11:13:24 avojak-eOS plank.desktop[1992]: [INFO 11:13:24.850977] SQLClient.vala:39: Database file: iridium01.db\n```\n\nThis can also be useful to locate where the application started amidst all of the journal entries.\n\n#### Config Files\n\nWith Flatpak, application config files can be found in: `~/.var/app/com.github.avojak.iridium/`\n\n## Project Status\n\nThis project is very much in-progress and has a lot of remaining work. Check out the [Projects](https://github.com/avojak/iridium/projects) page to track progress towards the next milestone.\n\nPlease keep in mind that at this time I am developing Iridium as a personal project in my limited free time to learn Vala and contribute back to the [elementary OS](https://elementary.io) community, so do not be offended if I reject a pull request or other contribution.\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://www.buymeacoffee.com/avojak\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\u003c/p\u003e\n","funding_links":["https://liberapay.com/avojak","https://cash.app/$avojak","https://venmo.com/avojak","https://www.paypal.me/avojak","https://www.buymeacoffee.com/avojak"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favojak%2Firidium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favojak%2Firidium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favojak%2Firidium/lists"}