{"id":13418463,"url":"https://github.com/tryone144/compton","last_synced_at":"2025-03-15T03:31:16.311Z","repository":{"id":47955044,"uuid":"122062040","full_name":"tryone144/compton","owner":"tryone144","description":"A compositor for X11.","archived":false,"fork":true,"pushed_at":"2021-07-08T15:37:09.000Z","size":3681,"stargazers_count":616,"open_issues_count":17,"forks_count":235,"subscribers_count":21,"default_branch":"dual_kawase","last_synced_at":"2024-07-31T22:43:07.392Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"chjj/compton","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tryone144.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}},"created_at":"2018-02-19T12:52:55.000Z","updated_at":"2024-06-07T08:20:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tryone144/compton","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/tryone144%2Fcompton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryone144%2Fcompton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryone144%2Fcompton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryone144%2Fcompton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tryone144","download_url":"https://codeload.github.com/tryone144/compton/tar.gz/refs/heads/dual_kawase","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681024,"owners_count":20330152,"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-30T22:01:02.619Z","updated_at":"2025-03-15T03:31:16.305Z","avatar_url":"https://github.com/tryone144.png","language":"C","funding_links":[],"categories":["Installation","Requirements","C"],"sub_categories":["1) Get all the dependencies","2) Install the dependencies","yellow theme"],"readme":"# Compton\n\n[![Join the chat at https://gitter.im/chjj/compton](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/chjj/compton?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n__Compton__ is a compositor for X, and a fork of __xcompmgr-dana__.\n\nThis branch includes a new blur method: The multi-pass **dual_kawase blur**!\nUse it with the `--blur-method dual_kawase` and `--blur-strength LEVEL` options.\nOnly works with the `glx` backend!\n\n## Deprecation Notice\n\nThis fork contains more of a proof-of-concept than a polished implementation of the *dual-filter kawase blur*.\nAs you may have noticed, the development on compton seems to have halted.\n[**picom**](https://github.com/yshui/picom) is a compton-fork that is actively maintained and has superseeded compton in most distributions already.\nAs of Aug, 31st 2020, picom comes with a better optimized and polished [implementation](https://github.com/yshui/picom/pull/382) of the *dual-filter kawase blur*, that will be part of the next regular release (v9).\n\nThis fork will most likely not receive any future improvements or fixes.\n**I strongly suggest you give picom a try, unless you absolutely have to use compton.**\n\n---\n\nI was frustrated by the low amount of standalone lightweight compositors.\nCompton was forked from Dana Jansens' fork of xcompmgr and refactored.  I fixed\nwhatever bug I found, and added features I wanted. Things seem stable, but don't\nquote me on it. I will most likely be actively working on this until I get the\nfeatures I want. This is also a learning experience for me. That is, I'm\npartially doing this out of a desire to learn Xlib.\n\n## Changes from xcompmgr:\n\n* OpenGL backend (`--backend glx`), in addition to the old X Render backend.\n* Inactive window transparency (`-i`) / dimming (`--inactive-dim`).\n* Titlebar/frame transparency (`-e`).\n* Menu transparency (`-m`, thanks to Dana).\n* shadows are now enabled for argb windows, e.g. terminals with transparency\n* removed serverside shadows (and simple compositing) to clean the code,\n  the only option that remains is clientside shadows\n* configuration files (see the man page for more details)\n* colored shadows (`--shadow-[red/green/blue]`)\n* a new fade system\n* VSync support (not always working)\n* Blur of background of transparent windows, window color inversion (bad in performance)\n* Some more options...\n\n## Fixes from the original xcompmgr:\n\n* fixed a segfault when opening certain window types\n* fixed a memory leak caused by not freeing up shadows (from the freedesktop\n  repo)\n* fixed the conflict with chromium and similar windows\n* [many more](https://github.com/chjj/compton/issues)\n\n## Building\n\n### Dependencies:\n\n__B__ for build-time\n\n__R__ for runtime\n\n* libx11 (B,R)\n* libxcomposite (B,R)\n* libxdamage (B,R)\n* libxfixes (B,R)\n* libXext (B,R)\n* libxrender (B,R)\n* libXrandr (B,R)\n* libXinerama (B,R) (Can be disabled with `NO_XINERAMA` at compile time)\n* pkg-config (B)\n* make (B)\n* xproto / x11proto (B)\n* sh (R)\n* xprop,xwininfo / x11-utils (R)\n* libpcre (B,R) (Can be disabled with `NO_REGEX_PCRE` at compile time)\n* libconfig (B,R) (Can be disabled with `NO_LIBCONFIG` at compile time)\n* libdrm (B) (Can be disabled with `NO_VSYNC_DRM` at compile time)\n* libGL (B,R) (Can be disabled with `NO_VSYNC_OPENGL` at compile time)\n* libdbus (B,R) (Can be disabled with `NO_DBUS` at compile time)\n* asciidoc (B) (and docbook-xml-dtd-4.5, libxml-utils, libxslt, xsltproc, xmlto, etc. if your distro doesn't pull them in)\n\n### How to build\n\nTo build, make sure you have the dependencies above:\n\n```bash\n# Make the main program\n$ make\n# Make the man pages\n$ make docs\n# Install\n$ make install\n```\n\n(Compton does include a `_CMakeLists.txt` in the tree, but we haven't decided whether we should switch to CMake yet. The `Makefile` is fully usable right now.)\n\n## Known issues\n\n* Our [FAQ](https://github.com/chjj/compton/wiki/faq) covers some known issues.\n\n* VSync does not work too well. You may check the [VSync Guide](https://github.com/chjj/compton/wiki/vsync-guide) for how to get (possibly) better effects.\n\n* If `--unredir-if-possible` is enabled, when compton redirects/unredirects windows, the screen may flicker. Using `--paint-on-overlay` minimizes the problem from my observation, yet I do not know if there's a cure.\n\n* compton may not track focus correctly in all situations. The focus tracking code is experimental. `--use-ewmh-active-win` might be helpful.\n\n* The performance of blur under X Render backend might be pretty bad. OpenGL backend could be faster.\n\n* With `--blur-background` you may sometimes see weird lines around damaged area. `--resize-damage YOUR_BLUR_RADIUS` might be helpful in the case.\n\n## Usage\n\nPlease refer to the Asciidoc man pages (`man/compton.1.asciidoc` \u0026 `man/compton-trans.1.asciidoc`) for more details and examples.\n\nNote a sample configuration file `compton.sample.conf` is included in the repository.\n\n## Support\n\n* Bug reports and feature requests should go to the \"Issues\" section above.\n\n* Our (semi?) official IRC channel is #compton on FreeNode.\n\n* Some information is available on the wiki, including [FAQ](https://github.com/chjj/compton/wiki/faq), [VSync Guide](https://github.com/chjj/compton/wiki/vsync-guide), and [Performance Guide](https://github.com/chjj/compton/wiki/perf-guide).\n\n## License\n\nAlthough compton has kind of taken on a life of its own, it was originally\nan xcompmgr fork. xcompmgr has gotten around. As far as I can tell, the lineage\nfor this particular tree is something like:\n\n* Keith Packard (original author)\n* Matthew Hawn\n* ...\n* Dana Jansens\n* chjj and richardgv\n\nNot counting the tens of people who forked it in between.\n\nCompton is distributed under MIT license, as far as I (richardgv) know. See LICENSE for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryone144%2Fcompton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftryone144%2Fcompton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryone144%2Fcompton/lists"}