258
+ − 1 # Animia
+ − 2 Animia is a work-in-progress cross-platform hard fork of Anisthesia and part of
+ − 3 Minori.
+ − 4
+ − 5 Most (if not all) Anisthesia configs should also work in this library as well
+ − 6 (at least on Windows).
+ − 7
+ − 8 ## License
+ − 9 Changes divergent from Anisthesia are under the BSD 3-clause license. You can
+ − 10 find a copy of the original MIT license bundled with Anisthesia at `LICENSE.MIT`
+ − 11 in the root folder.
+ − 12
+ − 13 ## Support
+ − 14 Unlike Anisthesia, Animia currently does not support UI automation, i.e., most
+ − 15 web browsers will not work properly, if at all.
+ − 16
+ − 17 Animia will first attempt to connect to a windowing system. If that fails, it falls
+ − 18 back to just enumerating over the open processes in the system.
+ − 19
+ − 20 ## Platform-specific quirks
+ − 21
+ − 22 ### Windows
+ − 23 To get the currently opened file handles on Windows, Animia has to use internal
+ − 24 kernel functions. However, these functions aren't likely to change anytime soon.
+ − 25
+ − 26 ### macOS
+ − 27 The code to retrieve executable names on macOS uses internal functions. However,
+ − 28 if these functions cannot be found for whatever reason, it falls back to parsing
+ − 29 the arguments, and then to calling the kernel.
+ − 30
+ − 31 Additionally, macOS does not have the concept of class names, rather, it has
+ − 32 bundle identifiers, which are a suitable replacement in most use cases, and are
+ − 33 what Animia will try to grab before falling back to the Quartz window name.
+ − 34
+ − 35 ### X11
+ − 36 Animia requires that the XRes extension is installed to retrieve window PIDs.
