This repository public floppy images created by the users and easily accessible for the Atari ST community through the SidecarT Floppy Database.
The Sidecart ROM Emulator simulates the function of Atari ST cartridges, including their contained ROM memory, in line with classic TOS Atari ST applications, as prepared by the code in this repository. However, the functionality of Sidecart extends beyond the realm of simple ROM emulation; it also has the capacity to perform various additional operations.
One notable feature of Sidecart is its ability to emulate Floppy Drives. This is executed efficiently; it does not consume any system RAM space. The driver needed for this emulation is exclusively located in the cartridge ROM, ensuring that system resources are used optimally and system performance is maintained.
One of the popular features of the SidecarT is the search and download of floppy images from the public database. This repository is the public database of floppy images created by the users and easily accessible for the Atari ST community through the SidecarT Floppy Database.
- Host your floppy images in a public repository. The floppy images must be in .ST format, and it must be accessible through HTTP since HTTPS is not supported by the SidecarT firmware. The repository must be public and accessible without any authentication.
Example: I want to host a floppy image called SILLYDEMO.ST
in my public webserver in the URL http://ataristdb.sidecartridge.com/MISC/SILLYDEMO.ST
.
- Checkout this repository. Clone this repository in your local machine, or fork it and clone your fork. If you are not familiar with Git, you can follow the instructions in the Git documentation. As an alternative, you can also use edit directly the files explained in the next steps in the GitHub web interface.
Example:
git clone [email protected]:diegoparrilla/atarist-public-floppy-db.git
- Create your working branch. Create a new branch in your local repository to add your floppy image. The name of the branch should be descriptive of the floppy you are adding.
Example:
git checkout -b add-silly-demo
- Choose the folder with the category of your floppy. The floppy images are organized in folders by category. If you don't find a category that fits your floppy, you can create a new one. The name of the folder must be in uppercase and without spaces.
Example: I want to host the SILLYDEMO.ST
floppy in the CRACKTROS
category. I will use the CRACKTROS
folder.
- Edit the list.txt file. Inside the folder of the category, there is a file called
list.txt
. This file contains the list of floppy images in the category. Add a new line with the URL of your floppy image. As a respect to the Atari ST community, please add the content in alphabetical order, and use the following format:
"NAME OF THE APPLICATION";"URL OF THE FLOPPY IMAGE"
If the list.txt
file does not exist, create it.
Example:
"The Very Silly STE Demo (C) 2024 by @Logronoide";"http://ataristdb.sidecartridge.com/MISC/SILLYDEMO.ST"
- Commit your changes. Commit your changes to your local repository. You can use the following commands to commit your changes:
Example:
git add .
git commit -m "Add Silly Demo floppy"
- Push your changes. Push your changes to your fork of the repository. Please don't push directly to the main repository, as it is not allowed. Please create a pull request.
Example:
git push origin add-silly-demo
-
Wait for the pull request to be reviewed. After you push your changes, the pull request will be reviewed by the maintainers of the repository, and if everything is correct, it will be merged.
-
Celebrate!. Your floppy image is now available for the Atari ST community through the SidecarT Floppy Database.
Please ensure you have the following prerequisites before proceeding:
- The floppy image must be in .ST format.
- The floppy image must be accessible through HTTP since HTTPS is not supported by the SidecarT firmware.
- The service is case sensitive, so the URL must be in the same case as the file name.
- Sidecart ROM Emulator website
- Sidecart Raspberry Pico firmware - Where the second phase of the Sidecart ROM Emulator firmware evolution unfolds.
- Sidecart Floppy Emulator - The firmware with the floppy emulation functionality.
The project is licensed under the GNU General Public License v3.0. The full license is accessible in the LICENSE file.