# picom-allusive
See [What is This](https://github.com/allusive-dev/picom-allusive#what-is-this)
# Update
**If you use this package whatsoever or are intersted in its development, want to support future development or anything, please join the thread below where big changes to this package going ahead are being decided!**
[Thread - Issue 34](https://github.com/allusive-dev/picom-allusive/issues/34)
**There is now a live matrix chat room for Compfy/Picom-Allusive. Join us [here](https://matrix.to/#/#compfy:matrix.org)**
Want to chat or maybe help bug test? Contatct me here:
[](https://matrix.to/#/#compfy:matrix.org)
[](https://github.com/allusive-dev/allusive-dev#contact-me)
[](mailto:jasper@allusive.dev)
Thanks very much for the support on this project recently, it really helps me stay motivated to keep working on it.
Can we get to 100 stars on GitHub next?
**If you are feelling really generous I now have GitHub sponsors setup so you can support my work more directly.
Even if you can only give a small amount it goes a long way!**
[](https://github.com/sponsors/allusive-dev)
## Announcements
Please check out the updated documentation.
Current Featueres:
- Includes all fixes and changes from `yshui/picom-v10.2`
- Includes pijulius animation code. (
**As of `1.2.0` `animation-for-workspace-in`, `animation-for-workspace-out`, `animation-for-transient-window` have been removed because their corrosponding functions caused the issue of the wrong animations playing in all other instances, Aswell as not working as intended**
)
- Includes corners-rule. Allowing you to set the corner-radius on a per window basis.
- Animation open and unmap exclusion lists! Don't want something animating? Now you can fix that.
- Blur rules. Background blurring can now be done on a whitelist basis to reduce hardware consumption.
- Fixes rounded corner issues on AwesomeWM, bspwm and i3.
- A New option, `wm-support` has been added. Applies patches for ("awesome", "dwm", "herb"). "herb" being HerbstluftWM.
- Adds `inactive-exclude` and `active-exclude`. See Wiki or Donument for more information.
## What Is This?
This was originally a fork of pijulius and nothing more, but since `1.0` this project has become much more and I hope it will go even further with your help.
This is currently the best actively maintained fork of picom adding proper animations, implementing all features from upstream `v10.2` and adding more features as requested by the community!
## Documentation/Wiki.
The Wiki is also avaliable and actively updated on [Donument](https://donument.com/d/Allusive/picom-allusive/-/documents/) an up and coming git versioned database allows for more than just code to be versioned.
The GitHub Wiki is still actively maintained just incase, so don't worry about relying 100% on a external site yet if you don't feel comfortable with that. Thought I highly encourage taking a good look at Donument.
Can't find what you need in the wiki or have an problem? Open an Issue.
## Installation
### Building Manually
```
$ meson setup --buildtype=release . build
$ ninja -C build
$ ninja -C build install
```
Dependencies:
```
libconfig
libdbus
libev
libglvnd
libx11
libxcb
libxdg-basedir
pcre2
pixman
uthash
xcb-util-image
xcb-util-renderutil
gcc (make)
git (make)
meson (make)
ninja (make)
```
### Arch Linux or other Arch based distros
```
$ paru -S picom-allusive
```
or
```
$ yay -S picom-allusive
```
### NixOS
picom-allusive is avaliable on unstable(23.11)
Keep in mind it can take up to a week after picom is updated before it will be avaliable on NixOS.
Simply do one of the following
``` nix
environment.systemPackages = [ pkgs.picom-allusive ];
```
or for home-manager
``` nix
home.packages = [ pkgs.picom-allusive ];
```
The package will not be avaliable on NixOS 23.05 You will have to wait until the next stable update if you are on the stable branch.
**If you still want to use picom and you are on 23.05 you can use the custom package (updated in the releases page) in either `environment.systemPackages` or `home.packages` for home-manager users. Keep in mind this is considerably unstable so expect possible issues.**
Thank you for your patience.