{"id":13557764,"url":"https://github.com/aperezdc/revolt","last_synced_at":"2025-03-16T10:30:42.350Z","repository":{"id":56472466,"uuid":"72482553","full_name":"aperezdc/revolt","owner":"aperezdc","description":"Better desktop integration for Riot.im (not only) for GNOME","archived":false,"fork":false,"pushed_at":"2023-02-16T15:27:01.000Z","size":493,"stargazers_count":93,"open_issues_count":59,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-16T01:11:28.475Z","etag":null,"topics":["chat","client","gnome","webapp"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/aperezdc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-31T22:15:51.000Z","updated_at":"2025-02-27T07:38:35.000Z","dependencies_parsed_at":"2023-01-21T17:47:47.119Z","dependency_job_id":null,"html_url":"https://github.com/aperezdc/revolt","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Frevolt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Frevolt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Frevolt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Frevolt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aperezdc","download_url":"https://codeload.github.com/aperezdc/revolt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243858309,"owners_count":20359253,"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":["chat","client","gnome","webapp"],"created_at":"2024-08-01T12:04:31.997Z","updated_at":"2025-03-16T10:30:41.977Z","avatar_url":"https://github.com/aperezdc.png","language":"Python","funding_links":[],"categories":["Python","webapp"],"sub_categories":[],"readme":"![Logo](https://github.com/aperezdc/revolt/blob/master/assets/revolt-logo.png)\n\nRevolt\n======\n\nRevolt is a small application which wraps [Element](https://element.io) to\nprovide better integration with desktop environments in general, and\n[GNOME](http://www.gnome.org) in particular:\n\n* Having Element as a “standalone” application with its own window,\n  launcher, icon, etc. instead of it living in a browser tab.\n* Persistent notifications (for desktop environments supporting them, i.e.\n  GNOME). Notifications are automatically prevented when the Revolt window is\n  focused.\n* Status icon for desktop environment which have a tray bar applet (XFCE,\n  Budgie, likely many others).\n\n![Status icon in Budgie](https://github.com/aperezdc/revolt/blob/master/assets/revolt-statusicon-screenshot.png)\n![Application Window](https://github.com/aperezdc/revolt/blob/master/assets/revolt-screenshot.png)\n\n\nInstallation\n------------\n\nThe recommended installation method is to use [Flatpak](http://flatpak.org).\nStarting with version `0.6.13` using a single command is enough (if you want to\nintall in you user directory, add `--user` to the command):\n\n```sh\nflatpak install --from https://flatpak.perezdecastro.org/revolt.flatpakref\n```\n\nIf your Flatpak version is older than 0.6.13, use the following commands\ninstead:\n\n```sh\nwget https://flatpak.perezdecastro.org/revolt.flatpakref\nflatpak install --from revolt.flatpakref\nrm revolt.flatpakref\n```\n\nOnce installed, updates will be installed automatically when using `flatpak update`.\n\nYou can also download [the .flatpakref\nfile](https://flatpak.perezdecastro.org/revolt.flatpakref) and double-click on\nit to have GNOME Software install the application. GNOME Software will also\nnotify you of updates and give you the option to install them.\n\n### Portal Helpers\n\n**IMPORTANT**: Many distributions *do not* install the XDG helper programs for\nthe sandboxed applications, which are needed for some features to work. Please\ninstall them using your distribution's package manager:\n\n* Debian: [xdg-desktop-portal-gtk](https://packages.debian.org/search?keywords=xdg-desktop-portal-gtk).\n* Arch Linux: [xdg-desktop-portal-gtk](https://www.archlinux.org/packages/extra/x86_64/xdg-desktop-portal-gtk/).\n* Fedora: [xdg-desktop-portal-gtk](https://admin.fedoraproject.org/pkgdb/package/rpms/xdg-desktop-portal-gtk/).\n\nSome features, remarkably the desktop notifications, _will not work without the\nportal helpers_.\n\n### GNOME Runtime\n\nRevolt uses the GNOME Flatpak runtime. Depending on the version of Flatpak\ninstalled on your system, you may need to install it manually. You can check\nwhether the runtime is missing by trying to run Revolt in a terminal:\n\n```\n% flatpak run org.perezdecastro.Revolt\nerror: runtime/org.gnome.Platform/x86_64/3.22 not installed\n%\n```\n\nIf you need to install the runtime manually, you can do so by issuing the\nfollowing command:\n\n```\nflatpak [--user] remote-add --from gnome https://sdk.gnome.org/gnome.flatpakrepo\n```\n\nIf your Flatpak version is older than 0.6.13, use the following commands\ninstead:\n\n```sh\nwget https://sdk.gnome.org/keys/gnome-sdk.gpg\nflatpak [--user] remote-add --gpg-import=gnome-sdk.gpg gnome https://sdk.gnome.org/repo/\nflatpak [--user] install gnome org.gnome.Platform 3.22\n```\n\nManual Installation\n-------------------\n\nInstall the files to their locations:\n\n```sh\nsudo ./install.sh --prefix=/usr --log-file=install.log\n```\n\n(Specifying a log file is optional, but if you plan on [upgrading](#upgrading)\nlater on using the `install.sh` script, it is recommended to use it.)\n\nInstall the dependencies:\n\n```sh\nsudo apt-get install python-gobject python3-gi libwebkit2gtk-4.0\n```\n\nNow you should be able to launch Revolt from the GNOME Shell.\n\n### Upgrading\n\nThe `install.sh` script can be used to upgrade an existing installation as\nwell. The recommended way is to save a log of installed files, so the upgrade\nprocess can remove stray files from the old version. In general, the preferred\nway of invoking the installation script is as follows:\n\n```sh\nsudo ./install.sh --upgrade --prefix=/usr --log-file=/etc/revolt.files\n```\n\nThis way a log of the installed files is recorded the first time that the\ninstallation is done, and further upgrades will use it to remove stray files\nfrom old versions. Also, the log file will be updated with every upgrade.\n\n\nDevelopment\n-----------\n\nUsing `make run` executes Revolt in “development” mode: the needed resources\nare loaded from the source directory, instead of using the system-wide\ndirectories.\n\n\nFlatpak\n-------\n\nA bundle can be created using the included [make-flatpak.sh](make-flatpak.sh)\nscript. The script arranges calling `flatpak-builder` to build and create a\nrepository into `.flatpak-repo`. You can create a bundle from the repository\nusing:\n\n```sh\nflatpak build-bundle .flatpak-repo/ Revolt.flatpak org.perezdecastro.Revolt\n```\n\nOnce the bundle is created, you can install and run it with:\n\n```sh\nflatpak install --user --bundle Revolt.flatpak\nflatpak run org.perezdecastro.Revolt\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faperezdc%2Frevolt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faperezdc%2Frevolt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faperezdc%2Frevolt/lists"}