Magic Numbers Magic Numbers is an ad-free, offline, and open-source Android app that generates spiritual numerology messages based on the **Rhythm of the Moment**. All calculations are performed locally on the device using a deterministic numerology engine implemented in Kotlin. You can download the latest release directly from GitHub.

✨ Core Functionality (Based on Actual Engine Logic)

---

🔢 Rhythm of the Moment – Number Generation

• Numbers are generated on demand.
• The random generator is seeded using:

Random(System.currentTimeMillis())

• Default length: 6 digits
• Leading zeros are preserved.
• Fully deterministic per millisecond of interaction.

---

🧮 Cross Sum Calculation

Implemented in:

calculateCrossSum(number: String)

Behavior

1. All digits are summed.
2. If the result is greater than 9:
   • It is reduced step-by-step
   • Reduction stops if:
     • A single digit is reached
     • A master core number (11, 22, 33, 44) appears

Example:

0 + 8 + 2 + 0 + 0 + 9 = 19
1 + 9 = 10
1 + 0 = 1

The full reduction path is always displayed.

---

👑 Master Numbers

Core Master Numbers

Detected if either:

• Cross sum before reduction matches
• Reduced value matches

Supported core masters:

11, 22, 33, 44

Core master numbers have highest summary priority.

---

Amplifier Numbers

Detected by substring presence inside the number:

11, 22, 33, 44, 55, 66, 77, 88, 99

• Multiple amplifiers supported
• Ordered by appearance in the number
• Do not override core masters

---

🕊️ Angel Number Detection

Implemented in:

getAngelResIds(number)

1️⃣ Run Detection (Adjacent Repetition)

Triggered when at least two identical digits appear consecutively:

Examples:

00
11
222
3333
444444

• Supports up to 6 repetitions.
• No detection of non-adjacent patterns.
• No false positives.

---

2️⃣ Ascending Sequences

Detected dynamically:

123
1234
12345
123456

Other ascending sequences return a generic ascending message.

---

3️⃣ Descending Sequences

Detected dynamically (e.g., 654, 4321).

---

4️⃣ Mirror / Palindrome

Detected if:

number == number.reversed()

Special handling for 4-digit mirror format (ABBA).

---

5️⃣ Alternating Pattern

Detected for 4+ digits:

ABAB
1212
3434

Exact repetition required.

---

🔮 Resonance Pattern Recognition

Applied only for:

• 4-digit numbers
• 6-digit numbers

Implemented in:

getResonance(number)

---

4-Digit Resonance Patterns

• AAAA (Monotype)
• AABB
• ABAB
• ABBA
• None (fallback)

---

6-Digit Resonance Patterns

• AAAAAA (Monotype)
• AAABBB
• ABCABC
• Palindrome
• None (fallback)

Each resonance provides:

• Title
• Meaning
• Focus hint

---

🔁 Dominant Repeat Detection

Implemented in:

getDominantRepeatDigit(number)

If a digit appears 3 or more times, it influences:

• Summary
• Energy Flow

---

🌀 Frequency Score

Implemented in:

calculateFrequencyScore(number)

Formula:

average(digits) / 9.0

• Clamped between 0.1 and 1.0
• Displayed as percentage
• Visualized with HSV-based color gradient (0–120° hue)

---

🔥 Energy Flow

Implemented in:

getEnergyFlowResId(...)

Priority order:

1. Master Core
2. Dominant repeated digit
3. Reduced cross sum

Exactly one energy flow message is shown.

---

🧬 Karmic Detail

Based on:

sumBeforeReduce

Supported values:

1 – 33

Includes traditional karmic numbers: 10, 13, 14, 16, 19, etc.

---

🧠 Summary Prioritization Logic

Implemented in:

getSummaryResId(...)

Priority:

1. Master Core
2. Multiple Amplifiers
3. Dominant repeat (≥3)
4. Reduced cross sum

Angel numbers and resonance never override each other.

---

📋 Copy Output Structure

The generated clipboard text includes:

• Title
• Message for the moment
• Cross sum steps
• Master energy section
• Angel section
• Frequency %
• Digit vibration (unique digits only)
• Digit descriptions (with amplification text)
• Resonance section
• Summary
• Karmic detail (if applicable)
• Energy flow

Markdown formatting is cleaned before export.

---

🛠 Technical Details

• Language: Kotlin
• UI Framework: Jetpack Compose (Material 3)
• Architecture: Single Activity
• State Management: rememberSaveable
• Minimum SDK: 24 (Android 7.0)
• Target SDK: 35+
• License: MIT

No ads.
No tracking.
No analytics.
No internet required.

🌍 Localization

The app is fully translated into:

• 🇸🇦 Arabic (العربية)
• 🇧🇬 Bulgarian (Български)
• 🇨🇳 Chinese Simplified (简体中文)
• 🇭🇷 Croatian (Hrvatski)
• 🇨🇿 Czech (Čeština)
• 🇩🇰 Danish (Dansk)
• 🇳🇱 Dutch (Nederlands)
• 🇬🇧 English (UK)
• 🇺🇸 English (US)
• 🇪🇪 Estonian (Eesti)
• 🇫🇮 Finnish (Suomi)
• 🇫🇷 French (Français)
• 🇩🇪 German (Deutsch)
• 🇬🇷 Greek (Ελληνικά)
• 🇮🇱 Hebrew (עברית)
• 🇮🇳 Hindi (हिन्दी)
• 🇭🇺 Hungarian (Magyar)
• 🇮🇩 Indonesian (Bahasa Indonesia)
• 🇮🇹 Italian (Italiano)
• 🇯🇵 Japanese (日本語)
• 🇰🇷 Korean (한국어)
• 🇱🇻 Latvian (Latviešu)
• 🇱🇹 Lithuanian (Lietuvių)
• 🇳🇴 Norwegian (Norsk)
• 🇵🇱 Polish (Polski)
• 🇵🇹 Portuguese (Português)
• 🇷🇴 Romanian (Română)
• 🇷🇺 Russian (Русский)
• 🇷🇸 Serbian (Српски)
• 🇸🇰 Slovak (Slovenčina)
• 🇸🇮 Slovenian (Slovenščina)
• 🇪🇸 Spanish (Español)
• 🇸🇪 Swedish (Svenska)
• 🇹🇭 Thai (ไทย)
• 🇹🇷 Turkish (Türkçe)
• 🇺🇦 Ukrainian (Українська)
• 🇻🇳 Vietnamese (Tiếng Việt)

📱 Screenshots

Welcome Screen	Message View

(To display these images, create an art folder in the project's root directory and place your app's icon and screenshots there.)

🛠️ Built With

• Kotlin: As the primary programming language.
• Jetpack Compose: For the declarative and modern UI toolkit.
• Material Design 3: For design components and theming.
• Android Studio: As the Integrated Development Environment (IDE).

🚀 Getting Started

You can download the app from the Google Play Store (link will be added here once available) or build the project yourself.

Building from Source

1. Clone this repository:
2. Open the project in the latest version of Android Studio.
3. Let Gradle sync the project dependencies.
4. To sign the app for release, you will need to create your own keystore.properties file or modify the signingConfigs block in the app/build.gradle file.
5. Run the app on an emulator or a physical device.

🤝 Contributing

Contributions are welcome!

1. Fork the project.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.