Caution
Disclaimer: This software is currently in the development phase and is intended for developers. It is not suitable for general use in vehicles yet.
Warning
There is not documentation yet!
SmartifyOS is a base application (source code) that makes it easy for you to create a custom GUI for a DIY infotainment system in older cars. It is based on the Unity Game Engine, which means you have almost unlimited possibilities to customize it to your liking.
- The SmartifyOS base application which is made so that it can be customized a lot and build on top of whatever you want
- The full software for my Miata build on-top of the SmartifyOS base application
All scripts you can use as a base to make your own system are in Assets/SmartifyOS all other folders in Assets (mainly Scripts and ScriptableObjects) are using the code from Assets/SmartifyOS as a base and are specific for my car and setup (like Arduinos and sensors).
I also tried to make everything in Assets/SmartifyOS so that you shouldn't need to modify anything in it to work with your specific setup since all the project specific code is in Scripts and ScriptableObjects.
Since SmartifyOS is still in the development phase there will probably be cases where you need to modify smoothing in Assets/SmartifyOS. Then just keep in mind that anything in there should not be (too) project (car/setup) specific.
| Platform | Supported |
|---|---|
| Windows | yes* |
| Linux (Ubuntu) | yes |
| macOS | not tested |
*Some features like testing Bluetooth management and other things that rely on Linux don't work on a Windows systems
| Platform | Supported |
|---|---|
| Windows | no |
| Linux Ubuntu x86 | yes |
| Linux Ubuntu Arm | not tested (will be added) |
| Other Linux | not tested |
If you want to contribute to this project by for example fixing a bug or adding a feature install it like this:
- Install the Unity Editor
- Go to the repository’s GitHub page and click the “Fork” button to create a copy of the repository in your own GitHub account.
- Clone your new repo
git clone https://github.com/your-username/SmartifyOS.git - Cd into its directory
cd SmartifyOS - Add the Main Repository as a Remote
git remote add upstream https://github.com/Mauznemo/SmartifyOS.git - Open Unity Hub, click
Addand select the path of the repo you just cloned
If you don't plan to modify any code and only want to help find bugs or suggest features to add you can do it like this:
- Install the Unity Editor
- Clone the repo
git clone https://github.com/Mauznemo/SmartifyOS.git - Open Unity Hub, click
Addand select the path of the repo you just cloned
First have a look at the Contribution guidelines for this project.
Then if you haven't Installed it yet follow the steps here: Installation For contribution (modifying code)
If you're now in the project folder of your fork you can add a new branch for the feature you want to add or change:
git checkout -b your-branch-name
- Navigate to Your Forked Repository
- Compare & Pull Request:
- GitHub usually detects recent pushes and will show a prompt asking if you want to create a pull request. If this prompt appears, click on "Compare & pull request."
- If the prompt does not appear, click the "Pull requests" tab, then click the "New pull request" button.
- Select the Base and Compare Branches:
- Base repository: This should be the original repository you forked from.
- Base branch: Typically, this is the main or master branch of the original repository.
- Head repository: This should be your forked repository.
- Compare branch: Select the branch you just pushed.
- Create Pull Request and make sure to follow the Pull Request Guidelines
SmartifyOS-Installer - to auto install the build Unity app and all dependencies on the car's computer.
SmartifyOS-Documentation - documentation of all the SmartifyOS code and how to use it.
SmartifyOS-App - android app to lock and unlock the car from your phone.
SmartMiata - all Arduino code I used for my Miata