Salvatore (SAHL-vah-tor-eh, named after the Swiss mountain) is an open-source virtualization software.

Documentation

Salvatore currently does not have detailed documentation explaining how the software works. Please check back later!

Note

You can contribute to the documentation once the project stabilizes. However, it is still in early development, so it's better to wait for more features to be implemented.

To-do List

Tip

If you think anything is missing here, feel free to create an issue, and we'll review it!

• CPU Emulation
• Bootloader finished
• BIOS services
• Virtual devices

Get Started

Warning

This application is currently untested on macOS and Linux. Development has primarily been done on Windows.

To get started, you will need G++:

• Windows: Install MSYS2.
• Linux: Install G++ by running sudo apt install g++.
• macOS: G++ is installed with Xcode Command Line Tools.

No additional libraries are required as they are included in the lib/ folder.

1. Download the repository and compile it with:

   g++ main.cpp BIOS.cpp BIOS.cpp parsing.cpp datareader.cpp filesystem.cpp bootloader.cpp VirtualMachine.cpp allocation.cpp VirtualMachine.cpp allocation.cpp cpu.cpp sample.cpp -o salvatore

2. Then run:

   ./salvatore

An .exe file will be created in the directory. Salvatore is now compiled and ready to use.

Reporting Issues

Before reporting an issue, make sure it hasn't already been reported in the issue tracker.

When reporting an issue, please provide as much relevant information as possible:

• The version of Salvatore you're running
• Steps to reproduce the issue
• Any error messages or logs (both UI and console)
• Possible fixes or solutions

If you forget something, we'll ask for it later.

Contributing

Feel free to fork the repository, make changes, and submit a pull request. Contributions are always welcome!