Do not post installation issues in this thread. Open a help thread or reply on the thread where you found the Wineskin.
osu!macOS Agent is a tool designed for troubleshooting macOS installation issues and contains some other miscellaneous features.
Features
- Automatically move maps from the Downloads folder.
- Automatically move skins from the Downloads folder.
- Automatically open replays from the Downloads folder.
- Button to manually update osu! executable
- Button to open the osu! folder
Troubleshooting checks
- Compatibility mode
- Wineskin detect Direct3D
- System Integrity Protection
- Supported engine version
- Log file errors
- Quarantine attribute
- Execute flag
- Razer Synapse
Some of these checks are automatically fixable (most importantly, the quarantine attribute that prevents osu! from opening). A complete list of checks performed is available on the project page: https://github.com/Techno-coder/osu-macOS-Agent.
Download page (click the zip file): osu-macOS-Agent/releases/tag/refs/heads/master
Alternative link: https://mega.nz/file/Eot2GDhb#b-D_9mVRvxWU7qmuWeEsLoFmPLUBlGGX0XlxLWauwrw
Please submit any issues with installing osu! itself on my Wineskin page:
community/forums/topics/1106057
or open a help thread with the label macOS.
Do not post installation issues here.
Installation steps
- Download the zip file from one of the above download links
- Extract the zip file by double clicking on it
- Right click on the extracted application and press Open
- Click on the open button if it appears, otherwise:
- Press cancel on the dialog that appears
- Open System Preferences and click on Security & Privacy
- Click Open Anyway
- Click Open on the dialog that shows
- Click on the Select button
- Select the osu! application and press Open
- Click on the Troubleshoot tab
- Click the Scan button
- Click the Repair button
- Click the Copy Report button to copy a report to the clipboard
Sample Report
Version 10.14.6 (Build 18G103)
Engine: WS9Wine2.22
Wineskin 2.6.2
Release: Stable40
Quarantine attribute is absent
Detect Direct3D is disabled
Compatibility mode is disabled
Razer Synapse is absent
System Integrity Protection is enabled
Engine version is supported
[Warning] Errors in: update.log
2019-12-10T05:18:32: _pending\discord-rpc.dll => discord-rpc.dll: FAIL
2019-12-10T05:18:33: _pending\osu!.exe => osu!.exe: FAIL
2019-12-10T05:49:40: _pending\discord-rpc.dll => discord-rpc.dll: FAIL
2019-12-10T05:49:40: _pending\osu!.exe => osu!.exe: FAIL
2019-12-11T11:50:02: osu!.exe: MISMATCH
2019-12-11T11:50:21: _pending\discord-rpc.dll => discord-rpc.dll: FAIL
2019-12-11T11:50:21: _pending\osu!.exe => osu!.exe: FAIL
2019-12-11T11:50:21: _pending\osu!seasonal.dll => osu!seasonal.dll: FAIL
2019-12-11T11:50:21: _pending\osu!ui.dll => osu!ui.dll: FAIL
2019-12-16T11:27:17: _pending\osu!.exe => osu!.exe: FAIL
2019-12-16T11:28:26: _pending\osu!seasonal.dll => osu!seasonal.dll: FAIL
2019-12-16T11:28:26: _pending\osu!ui.dll => osu!ui.dll: FAIL
2019-12-27T09:32:54: osu!.exe: MISMATCH
2019-12-27T09:33:33: _pending\osu!.exe => osu!.exe: FAIL
2019-12-27T09:33:34: _pending\osu!seasonal.dll => osu!seasonal.dll: FAIL
2019-12-27T09:33:34: _pending\osu!ui.dll => osu!ui.dll: FAIL
2020-03-15T04:04:15: bass.dll: MISMATCH
No errors in: runtime.log
Engine: WS9Wine2.22
Wineskin 2.6.2
Release: Stable40
Quarantine attribute is absent
Detect Direct3D is disabled
Compatibility mode is disabled
Razer Synapse is absent
System Integrity Protection is enabled
Engine version is supported
[Warning] Errors in: update.log
2019-12-10T05:18:32: _pending\discord-rpc.dll => discord-rpc.dll: FAIL
2019-12-10T05:18:33: _pending\osu!.exe => osu!.exe: FAIL
2019-12-10T05:49:40: _pending\discord-rpc.dll => discord-rpc.dll: FAIL
2019-12-10T05:49:40: _pending\osu!.exe => osu!.exe: FAIL
2019-12-11T11:50:02: osu!.exe: MISMATCH
2019-12-11T11:50:21: _pending\discord-rpc.dll => discord-rpc.dll: FAIL
2019-12-11T11:50:21: _pending\osu!.exe => osu!.exe: FAIL
2019-12-11T11:50:21: _pending\osu!seasonal.dll => osu!seasonal.dll: FAIL
2019-12-11T11:50:21: _pending\osu!ui.dll => osu!ui.dll: FAIL
2019-12-16T11:27:17: _pending\osu!.exe => osu!.exe: FAIL
2019-12-16T11:28:26: _pending\osu!seasonal.dll => osu!seasonal.dll: FAIL
2019-12-16T11:28:26: _pending\osu!ui.dll => osu!ui.dll: FAIL
2019-12-27T09:32:54: osu!.exe: MISMATCH
2019-12-27T09:33:33: _pending\osu!.exe => osu!.exe: FAIL
2019-12-27T09:33:34: _pending\osu!seasonal.dll => osu!seasonal.dll: FAIL
2019-12-27T09:33:34: _pending\osu!ui.dll => osu!ui.dll: FAIL
2020-03-15T04:04:15: bass.dll: MISMATCH
No errors in: runtime.log
Bug reports
Found a bug or something you're confused about? Reply to this thread or submit an issue here: https://github.com/Techno-coder/osu-macOS-Agent/issues
Feature requests
Is there a feature or suggestion that you think might be helpful? Reply to this thread or submit it here: https://github.com/Techno-coder/osu-macOS-Agent/issues
Contributing
Users: If your osu! installation is working and the report shows an error (not a warning) please post your report as a reply to this thread.
Developers: Bug fixes and miscellaneous changes are welcome and can be submitted on the project page.
Technical information
This project was built using C# with Xamarin. The Github releases are built directly from the Github Actions continuous integration pipeline which can be found here: https://github.com/Techno-coder/osu-macOS-Agent/blob/master/.github/workflows/main.yml which guarantees that no malicious code is present in the final artefact (you are encouraged to check the code yourself and submit any fixes or feature additions!).
Release notes
- 8/3 - Extract skins on file watch
- 18/3 - Add execute flag check
- 18/3 - Add button to update executable
- 30/3 - Add automatic replay open
- 15/7 - Fix integrity and Direct3D check for new system versions
- 12/10 - Add stricter quarantine attribute check
- 12/10 - Restrict selectable items by file extension
- 11/11 - Fix strict filename replacement (thanks @Death)
- 22/1 - Add wrapper quarantine check and support new engines
- 1/2 - Unconditionally disable GPU detection