Skip to content

Commit 97c0572

Browse files
authored
Create README.md
1 parent b0a3e93 commit 97c0572

File tree

1 file changed

+108
-0
lines changed

1 file changed

+108
-0
lines changed

README.md

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
# 🎛️ Therminous2 – Mobile Sensor Synthesizer
2+
3+
**Therminous2** is a research-driven Android application that transforms your smartphone into a real-time audio synthesizer. It captures live data from your phone's built-in sensors—**Altitude**, **Latitude**, **Longitude**, and **Gyroscope (X, Y, Z)**—to generate evolving electronic sounds inspired by the **theremin**.
4+
5+
This project explores the relationship between **motion, space, and sound**, offering a new way to interpret physical data through continuous, dynamic audio.
6+
7+
---
8+
9+
## 🔬 Project Description
10+
11+
Therminous2 is part of an ongoing artistic research project led by **Zeligmax**, focused on developing accessible, sensor-based sound tools. The app maps physical data to sonic parameters using basic waveform synthesis, creating an expressive and interactive sound experience without the need for touch input.
12+
13+
Possible applications include:
14+
- Experimental music and sound design
15+
- Performative installations
16+
- Accessibility and sensory augmentation
17+
- Data sonification for research or education
18+
19+
---
20+
21+
## 📱 Features
22+
23+
- 🎚️ **Real-time sound synthesis** from 6 motion and location parameters
24+
- 🎵 Multiple waveform options: *sine*, *square*, *triangle*, and *theremin-style continuous tones*
25+
- 🌍 Supports negative and wide-range geographic values
26+
- 🎛️ **Theremin Mode**: cleaner, smoother tone behavior
27+
- 📊 Live visualization of sensor values
28+
- 🔧 Adjustable **sensitivity** and **waveform type**
29+
30+
---
31+
32+
## 🚀 Getting Started
33+
34+
### Download APK
35+
36+
You can download and install the latest APK release [from the Releases tab](https://github.com/zeligmax/Therminous2/releases) or by sideloading it on your Android device.
37+
38+
### Permissions
39+
40+
The app requires:
41+
- **Location access** (for Altitude, Latitude, Longitude)
42+
- **Physical activity and motion sensors**
43+
44+
---
45+
46+
## 🧠 How It Works
47+
48+
- **Altitude, Latitude, Longitude** → influence pitch, tone range, or modulation
49+
- **Gyroscope (X, Y, Z)** → control vibrato, amplitude, waveform shifts, or audio filters
50+
51+
The audio engine is designed to generate **constant sound streams**, responding immediately and fluidly to even subtle changes in sensor values.
52+
53+
---
54+
55+
## 🎨 Design
56+
57+
Therminous2 features a minimalist interface inspired by early sci-fi aesthetics (Star Wars, *2001: A Space Odyssey*) and analog synthesizers. The focus is on function, clarity, and direct interaction with invisible data.
58+
59+
---
60+
61+
## 🛠️ Built With
62+
63+
- **Android Studio (Kotlin / Java)**
64+
- **AudioTrack API** for low-latency sound synthesis
65+
- **SensorManager** for real-time data access
66+
67+
---
68+
69+
## 📚 Research Context
70+
71+
This app is part of a broader research and artistic project titled **“Wheels On Motion”**, investigating how wheelchair mobility and urban barriers can be expressed through sound. By using geolocation and motion data, Therminous2 helps turn everyday physical experience into a musical language.
72+
73+
---
74+
75+
## 👤 Author
76+
77+
Developed by **Zeligmax**
78+
💬 [github.com/zeligmax](https://github.com/zeligmax)
79+
80+
---
81+
82+
## 🧪 Roadmap
83+
84+
- Add data recording & export (.csv)
85+
- Implement granular synthesis engine
86+
- Bluetooth audio streaming
87+
- Expanded sensor-to-sound mapping presets
88+
- Accessibility-focused sound modes
89+
90+
---
91+
92+
## 🤝 License
93+
94+
This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.
95+
96+
---
97+
98+
## 📸 Screenshots
99+
100+
*(Add screenshots of the app interface if available)*
101+
102+
---
103+
104+
## 🙌 Contributing
105+
106+
Pull requests, feature suggestions, and feedback are welcome!
107+
Feel free to open an issue or fork the repo.
108+

0 commit comments

Comments
 (0)