BeatmapExporter 2.5.0 (48)

• Update to support osu!lazer database changes as of 19 March 2025. This update is required after osu!lazer update 2025.321.0.

• Greatly increased detail of messages provided when there is a database version mismatch, especially in the case of trying to open an older osu!lazer database (instead of assuming the database is newer)

• Reversed order of the system messages in the GUI so they can be read top-to-bottom.

  • There is a possibility of the bottom messages being cut off for users using Windows DPI scaling, but a warning has been added to the main readme about DPI scaling.
  • It's not worth having these backwards any longer, it was very confusing, especially with the increased error messages added now.

---

For the release files below:
BeatmapExporter files are the newer program version with a full GUI, this is now recommended for most users.
BeatmapExporterCLI files are the original command-line program.

BeatmapExporter 2.4.0 (47)

• Update to support osu!lazer database changes as of 26 December 2024. This update is required after osu!lazer update 2025.220.0.

• NEW: osu!stable collection.db export mode.

  • Exports selected beatmaps (after other filters are applied) that are also in an osu!lazer collection into the collection.db format usable with osu! stable.
  • Option added when in this export mode that causes the export to merge with an existing collection.db file if one is already located at the export location. This is enabled by default. This allows you to add your osu!lazer collections into an existing collection.db from osu! stable.
  • "Open Export Directory" button added to export page to facilitate this process.
  • Additional option added when in this export mode performs case-insensitive merging by default ("dt" and "DT" collections would become one).

• GUI: Moved export button on filter page to settings side and made text larger to make it harder to miss.

• FIX (GUI): Added missing export results to main message log for non-beatmap export modes.

• FIX: Build script creates .zip archive for macOS .app file to allow upload on GitHub.

BeatmapExporter 2.4.0-pre (46)

This is a prerelease for BeatmapExporter 2.4.0, which will contain a new export mode for exporting collections to osu!stable.

• NEW: osu!stable collection.db export mode.
  • Exports selected beatmaps (after other filters are applied) that are also in an osu!lazer collection into the collection.db format usable with osu! stable.
  • Option added when in this export mode that causes the export to merge with an existing collection.db file if one is already located at the export location. This is enabled by default. This allows you to add your osu!lazer collections into an existing collection.db from osu! stable.
  • "Open Export Directory" button added to export page to facilitate this process.
  • Additional option added when in this export mode performs case-insensitive merging by default ("dt" and "DT" collections would become one).
• GUI: Moved export button on filter page to settings side and made text larger to make it harder to miss.
• FIX (GUI): Added missing export results to main message log for non-beatmap export modes.
• FIX: Build script creates .zip archive for macOS .app file to allow upload on GitHub.

BeatmapExporter 2.3.0 (46 [24])

This release contains a required database file format update to function with the latest lazer. Specifically, this update is required after osu!lazer version 2025.118.0 despite the database version (the 46 in this page's title) not changing with this release.

Opening current osu!lazer databases with previous BeatmapExporter releases is showing an error regarding "file format version 24", which is fixed by this release. This is a different kind of update and will not show the typical error message nor did I notice the change when lazer updated (so this update is a bit delayed). #28

• FIX: Added missing handling for this type of error in the future.
• FIX (GUI): Added some handling to display errors for other odd cases. #27

This release also contains some improvements to the macOS build as I set up a testing environment and can see the program running on macOS now. This was finally prompted by #26 but generally have had many people confused how to launch the program on macOS.

• Notice added to the main README about running on macOS (and Linux), regarding how you must allow execute permissions for the program.
• macOS GUI application now ends with the .app extension representing how it is packaged and allowing it to be clickable.
• FIX (GUI): Margin added to the top menu bar when running on macOS to avoid the program menu overlapping with the left side title bar buttons.
• FIX (GUI): Now displays "BeatmapExporter" in the macOS system menu bar rather than the generic name.
   

---

For the release files below:
BeatmapExporter files are the newer program version with a full GUI, this is now recommended for most users.
BeatmapExporterCLI files are the original command-line program.

BeatmapExporter 2.2.6 (46)

• Update to support osu!lazer database changes as of 26 December 2024. This update is required after osu!lazer update 2025.101.0.

---

For the release files below:
BeatmapExporter files are the newer program version with a full GUI, this is now recommended for most users.
BeatmapExporterCLI files are the original command-line program.

BeatmapExporter 2.2.5 (45)

• Update to support osu!lazer database changes as of 23 December 2024. This update is required after osu!lazer update 2024.1224.1.

---

For the release files below:
BeatmapExporter files are the newer program version with a full GUI, this is now recommended for most users.
BeatmapExporterCLI files are the original command-line program.

BeatmapExporter 2.2.4 (44)

This version contains some bug fixes from version 2.2.3 (listed again here) as well as a required database version update to function with the latest lazer.

• Update to support osu!lazer database changes as of 22 Nov 2024. This update is required after osu!lazer version 2024.1208.0.

• NEW (GUI): Messages which are intended as errors are now displayed as red.

• FIX #24: Transcoding audio files to .mp3 should behave more predictably. Notably, .mp3 files being transcoded would fail to apply song metadata to the .mp3 file, and generally lie about progress in the GUI progress bar.

---

For the release files below:
BeatmapExporter files are the newer program version with a full user interface, this is now recommended for most users.
BeatmapExporterCLI files do not have a GUI and use the original command-line program style.

BeatmapExporter 2.2.3 (43)

This update is not required and only provides a minor bug fix for the .mp3 export mode.

• FIX #24: Transcoding audio files to .mp3 should behave more predictably. Notably, .mp3 files being transcoded would:
  • Fail to apply song metadata to the .mp3 file
  • Lie about progress in the GUI

BeatmapExporter 2.2.2 (43)

• Update to support osu!lazer database changes as of 14 October 2024. This update is required after osu!lazer update 2024.1115.1.

---

For the release files below:
BeatmapExporter files are the newer program version with a full GUI, this is now recommended for most users.
BeatmapExporterCLI files are the original command-line program.

BeatmapExporter 2.2.1 (42)

This update is not required unless you are affected by the issue below.

• FIX: Now ignoring files within beatmaps with blank/missing filenames. The cause of these is unknown but may have been a bug with lazer's import function at some point.

---

For the release files below:
BeatmapExporter files are the newer program version with a full GUI, please let me know if there are any major issues with the program on your system.
BeatmapExporterCLI files are the original command-line program.