Windows
Compatible applications
Quick Facts
Basic information about this file format
Extension
.BSML
File Type
BeatSaber Markup Language
Category
Programming
Best first step
Use compatible software
Quick Summary
A practical overview of the .bsml file format
BeatSaber Markup Language (BSML) is a specialized XML-based markup language used primarily within the modding community of the virtual reality rhythm game, Beat Saber. Developed to simplify the creation of custom user interfaces for game modifications, BSML allows developers to define complex UI la…
File extension
.BSML
File type
BeatSaber Markup Language
Category
Programming
Recommended action
Open with a trusted compatible app
How to open a .bsml file
Start with a trusted app that supports this format
- Check the file extension carefully and confirm that the file name really ends with .bsml.
- Use software that supports this file type. If one app does not work, try another compatible program for the same platform.
- Update the application if the file was created by a newer version of the software.
- Scan files from unknown sources before opening them, especially documents, archives, scripts, installers, and executable files.
What is a .bsml file?
File extension details and usage information
BeatSaber Markup Language (BSML) is a specialized XML-based markup language used primarily within the modding community of the virtual reality rhythm game, Beat Saber. Developed to simplify the creation of custom user interfaces for game modifications, BSML allows developers to define complex UI layouts, buttons, sliders, and text fields using a declarative syntax similar to HTML or XAML. Instead of writing verbose C# code to manually instantiate and position Unity UI elements, modders can write BSML files that are parsed at runtime to generate the interface. This format is heavily integrated with the BeatSaberMarkupLanguage library, which handles the binding between the XML tags and the underlying Unity components. It supports features like layout groups, scrolling views, and event handling through C# controllers. Because it is essentially a text-based XML format, it is easily readable and editable using standard text editors, making it an essential tool for anyone developing plugins or custom menus for the Beat Saber VR experience. It streamlines the development process by separating the visual presentation from the underlying logic of the mod.
Software Compatibility
Programs that may open or work with .bsml files
macOS
Compatible applications
Linux
Compatible applications
Mobile
Mobile applications
Can .bsml files be converted?
Options for saving or exporting this file to another format
In many cases, a .bsml file can be converted by opening it in compatible software and using an option such as Save As, Export, or Convert. The available output formats depend on the file type and the application used.
- Use the original software that created the file when possible.
- Check whether the application supports exporting to common formats.
- Be careful with online converters when working with private, business, or sensitive files.
- If conversion fails, the file may be corrupted, incomplete, encrypted, or not actually a .bsml file.
Why can't I open a .bsml file?
Common reasons this file type may not open correctly
Wrong software
The file may require a specific program that supports the .bsml format.
Incorrect extension
The file extension may have been renamed manually, even though the actual file format is different.
Corrupted file
The file may be incomplete, damaged during download, or transferred incorrectly.
Outdated app
Your software may need to be updated before it can open newer versions of this file format.
Frequently Asked Questions
Common questions about .bsml files
To open a .bsml file, use software that supports this file format.
- Visual Studio Code
- Notepad++
- Sublime Text
- Atom
- BBEdit
Open the file in compatible software and look for options such as Save As, Export, or Convert. If no export option is available, the file may require a specialized converter or the original application that created it.
- Verify that the file extension is correct.
- Install or update compatible software.
- Try another application that supports this format.
- Check whether the file is corrupted, incomplete, or encrypted.
A file extension alone does not guarantee whether a file is safe or unsafe. Only open files from trusted sources, scan unknown files before opening them, and be especially careful with executable, script, archive, and document files.
File safety tips
Use caution with unknown files
Only open files from trusted sources. Before opening a .bsml file, scan it with antivirus software, verify that the file extension is expected, and avoid running unknown executable, installer, macro-enabled document, or script files.