Submit Extension
Extension submission is temporarily down. Please reach out to SAMMI Dev Team on Discord to manually add an entry for you.
Create an extension
SAMMI communicates with all its extensions via Bridge.html and its own websocket.
Information about how to make your own extension can be found in SAMMI/Bridge/how to make an extension.txt
file.
We encourage you to go over a few premade extensions to understand the process.
Test an extension
Developed a new extension? Head over to our #development channel in the official SAMMI Discord server where you can post it for testing!
Release an extension
Is your extension ready to be released to public? Have you fully tested its functionality? Great! You can use the form below to submit it!
Rules for submitting a new extension
- Ensure the extension does not violate our extension policy
Before submitting an extension, read and follow the Extension Policy to ensure that your extension is allowed in official public spaces such as this one. - The extension and its name is unique
Do not release slightly modified existing extensions or extensions with a very similar functionality, but rather collaborate with the original author. Do not copy and paste code from other extensions without the explicit approval from the original author. - You’ve tested the extension extensively
The best way to test an extension is to download a clean copy of SAMMI, use a clean Bridge file and use a new scene collection in your OBS. Even better way is to share it with a few select beta testers to test it with different setups. - Publicly accessible source code
If your extension is not publicly accessible, you must provide us a way to verify its source code before having it posted on the website. This is to protect users from downloading malicious extensions. Contact one of the SAMMI Discord mods before submitting your extension in this case. - The extension is hosted on a secure server (
https
)
We recommend using Github where you can easily create a new account to upload your creations. - No obscure external libraries
Unless you’re a verified extension developer in our Discord server, do not link to obscure external libraries in the extension file. - Follow best coding practices
- do not pollute global namespace
Users can have dozens of different extensions installed. Try to avoid using global variables both in SAMMI and Bridge. - optimize loops in Bridge
- beware of memory leaks in Bridge
For example, calling an api every second might cause a memory leak and subsequent crash as some streamers run Bridge for 5+ hours without refreshing it. - do not overwrite global event handlers in Bridge
For example, instead ofwindow.onload
useaddEventListener()
method. - leave comments where needed
- do not pollute global namespace
- We reserve the right to reject or delete an existing extension for any reason or no reason, and without notice to you.