# Getting Kitsune Tails working on macOS ## Notes *A unaffiliated fan/community set of instructions to get Kitsune Tails on macOS.* *Following works with what I tested, there could be better or other settings that work.* Ping me at [@antijingoist@hackers.town](https://hackers.town/@antijingoist) Crossposted to my blog: https://abbiegonzalez.com/getting-kitsune-tails-working-on-macos ### Some Background on why it can be Difficult for Indie Devs * [FNA developer Ethan Lee's reasons for not working on new macOS ports](https://icculus.org/finger/flibitijibibo?date=2021-01-01&time=11-53-38) * [Reasons behind FNA not having ARM binaries](https://github.com/FNA-XNA/FNA/issues/318) and [the official current status](https://fna-xna.github.io/docs/appendix/Appendix-F%3A-Upcoming-Support-Changes/#macos-support-single-assembly) * [The current attempt to charge 20%-30% of all a company's digital sales in the EU, with notes on past actions](https://www.theverge.com/2024/8/9/24216181/apple-eu-app-store-services-fee-external-links) ### Can't Post About Apple Without Mentioning * [Ashley Gjovik's legal battle and documentation of abuse and poisoning communities and employees](https://www.ashleygjovik.com) ## Running Kitsune Tails as a Native Intel macOS App (Works on Apple Silicon) ### Caveats: README PLS * There were libraries that needed linking and some of the binary libraries need to be recompiled for ARM. * [FNA docs to make this](https://fna-xna.github.io/docs/3%3A-Distributing-FNA-Games/#macos) * Known issues * You may experience moments where you can't play Haunted Heist or Mods. * The libraries are compiled for Intel. It'll work just fine, but if you really want native Arm, give me some time. * It won't recognize your XBox360 controller that you've had for forever because Apple made that decision ([depreciated kernel extensions, but still](https://github.com/360Controller/360Controller/issues/1139)). That includes 8BitDo wired controllers. Works with other controllers that macOS does support. ### I had help: * [@eniko@peoplemaking.games](https://peoplemaking.games/@eniko) for this fracking OMG great game, and for pointing me to FNA docs and answering questions. * [@abstractcow@tech.lgbt](https:///tech.lgbt/@abstractcow) for the audio solution in Wine and for testing the initial version of the native mac instructions. * [@Dreamship@infosec.exchange](https://infosec.exchange/@Dreamship) for testing that helped me find missing files, and that I forgot to mention KitsuneTails.exe was needed. * [@oscherler@tooting.ch](https://tooting.ch/@oscherler) for confirming only the windows copy of Kitsune Tails was needed. ### Instructions * Download the latest Kitsune Tails App package ["KitsuneTailsShell_v2.zip"](https://app.box.com/s/zhl43m5i0r12cpxvdlnzx7cacyd99ko0) and extract it.[All versions](https://app.box.com/s/f8hcj6oua2ltt6yyv8q2zkwxzb8sryy7) * Right click the Kitsune Tails App and [select "Show Package Contents"](https://i.abbiecod.es/xlrhb9sD) * Navigate to Contents/Resources. [You should see a folder with items already in it](https://i.abbiecod.es/yWT8NYTl). * Download the latest Kitsune Tails for Windows, from wherever you purchased it. On Steam, you may need to install steam on a linux VM or computer to retrieve the package. Or purchase from Itch.io (if someone has success using only the windows version let me know). * Place the *contents of* the Kitsune Tails Windows directory into the [Resources directory of the Kitsune Tails App](https://i.abbiecod.es/9fgy4xf0). Do not overwrite files. * Place Kitsune Tails.app into your Applications folder (technically should be able to run from anywhere). Right click and select Open. ### Upgrade To upgrade to the newest Kitsune Tails, copy the same files from the new Windows download the same way you did earlier, and override files when asked. ### Cheats * Run cheats by opening a terminal and typing `/Applications/Kitsune\ Tails.app/Contents/MacOS/KitsuneTails -cheats` * You can also instead use the [cheat code](https://steamcommunity.com/app/1325260/discussions/0/4522261847578638702/): Up, up, down, down, left, right, left, right, up, down, up, down ### Oh no, an issue: * If you experience an issue where System.Management is not found, let me know. * If the game Opens and Closes immediately, try opening a terminal and typing `chmod -R 755 /Applications/Kitsune\ Tails.app` * If you are not getting any output try opening a terminal and typing `/Applications/Kitsune\ Tails.app/Contents/MacOS/KitsuneTails` Send me terminal output on mastodon: [@antijingoist@hackers.town](https://hackers.town/@antijingoist) * Log files can be found in /Kitsune\ Tails.app/Contents/Resources ## Running Kitsune Tails Under Virtualization VMWare Fusion (free)/Parallels($): Install like normal. ### Haunted Heist shows a blank screen For Haunted Heist, open using the -angle parameter when running, or run Direct 3D Mode.bat instead of KitsuneTails.exe. Running in virtualization has no issues on my M2 MacBook Pro aside from haunted heist. ## Running Kitsune Tails in Whisky (Or Wine, or CrossOver) ### Adjust your mac's sound settings [via @abstractcow@tech.lgbt](https://tech.lgbt/@abstractcow/112887875011726593) : * Open Audio MIDI Setup ( `\Applications\Utilities\Audio MIDI Setup.app` ) * Find you're mac's sound output and set it to 96,000 Hz [Audio Midi Setup example](https://i.abbiecod.es/6VNC2g0b) ### Setup Kitsune Tails * Download Kitsune Tails! ### Setup Whiskey * Download Whisky and follow instructions when opening it: [Download Whisky](https://getwhisky.app) * Create a new Bottle. Selecting Windows 10 or higher.: [Create New Bottle Screenshot](https://i.abbiecod.es/bZfHmPzk) * Select Open C: Drive. [Open C: Drive screenshot](https://i.abbiecod.es/zcnMhMkj) * Copy the Kitsune Tails folder to the Program Files directory. * In Whisky, Select Run..., then select KitsuneTails.exe [File to select screenshot](https://i.abbiecod.es/PtpX18pr) * Whisky will run Kitsune Tails, but also pin it so you can easily run it later. ### Optimizing Whisky * Keeping Retina Mode off will run it at a lower resolution but scaled larger, which shouldn't be noticeable. * Enabling DXVK should allow the game to run more smoothly, with caveats ### Caveats * There is a 1-2 second interval where CPU usage spikes, stalling the game for a quarter of a second. This may likely be a wine issue. I've asked about it in the Heroic Discord: [Discord link to heroic support request](https://discord.com/channels/812703221789097985/1268926041578147882/1268926041578147882) # Running Kitsune Tails on Windows 11 on ARM ## Issues ### Haunted Heist shows a blank screen For Haunted Heist, open using the -angle parameter when running, or run Direct 3D Mode.bat instead of KitsuneTails.exe.