Astra

KO | EN

gitlite — search

#claude-code #claude #postgresql #php #mcp #containers #sql #windows #artificial-intelligence #ios

(★ 9)

Native Material3 Expressive replacement for DSBmobile

File Explorer

ZIP Download

- - build.yml
  - dev-build.yml
- .gitignore
- build.gradle.kts
- proguard-rules.pro
- - screenshot1.png
  - screenshot2.png
  - screenshot3.png
  - screenshot4.png
- fdroid.png
- github.webp
- icon.png
- obtainium.png
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- gradle-daemon-jvm.properties
- libs.versions.toml
.directory
.gitignore
build.gradle.kts
dev.wolly.dsbmaterial.yml
dsb-mock-server.sh
dsb_2.txt
Google_Sans_Flex.zip
gradle.properties
gradlew
gradlew.bat
guidelines.md
issues.txt
LICENSE
NOTICE
README.md
settings.gradle.kts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Material You Expressive alternative for DSBmobile**

[![Stars](https://m3-markdown-badges.vercel.app/stars/6/2/WollyDev24/DSBmaterial)](https://github.com/WollyDev24/DSBmaterial)
[![Issues](https://m3-markdown-badges.vercel.app/issues/1/2/WollyDev24/DSBmaterial)](https://github.com/WollyDev24/DSBmaterial/issues)
[![License](https://ziadoua.github.io/m3-Markdown-Badges/badges/Apache/apache2.svg)](https://raw.githubusercontent.com/WollyDev24/Astra/main/LICENSE)
[![Android](https://ziadoua.github.io/m3-Markdown-Badges/badges/Android/android3.svg)](https://github.com/WollyDev24/DSBmaterial/releases/latest)
[![Kotlin](https://ziadoua.github.io/m3-Markdown-Badges/badges/Kotlin/kotlin2.svg)](https://kotlinlang.org)
[![Website](https://ziadoua.github.io/m3-Markdown-Badges/badges/HTML/html2.svg)](https://wolly.is-a.dev/dsbmaterial)

</div>

A modern, native **Material You Expressive** replacement for the official
**DSBmobile** app. It shows your school's daily substitution plan in a clean,
fast and fully customizable interface.

The official DSBmobile app hasn't been updated in two years and isn't native at
all. Astra is built from scratch with **Kotlin** and **Jetpack Compose**.

---

## ✨ Features

- 🎨 **Material You Expressive design** — dynamic color, themes, motion
- 🎛️ **Theme picker** — many accent colors to choose from
- 🧩 **Home-screen widget** — the latest substitution plan at a glance
- 🔄 **Automatic background refresh** — always up to date
- 🗄️ **Archive** — browse past substitution plans
- 📅 **Calendar view** — see your schedule by date
- 🌐 **Local webserver** — share the plan on your home network
- 🐞 **Debug mode** — plus offline / state screens

## 📸 Screenshots

## ⬇️ Download

| Source | Link |
| ------ | ---- |
| **Obtainium** | [Add repository](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/WollyDev24/DSBmaterial) |
| **GitHub Releases** | [Latest release](https://github.com/WollyDev24/DSBmaterial/releases/latest) |
| **Website** | [wolly.is-a.dev/dsbmaterial](https://wolly.is-a.dev/DSBmaterial) |
| ~~F-Droid~~ | _Coming soon_ |

## 🧱 Built with

- [Kotlin](https://kotlinlang.org) + [Jetpack Compose](https://developer.android.com/jetpack/compose) / Material 3
- [OkHttp](https://square.github.io/okhttp/) · [jsoup](https://jsoup.org) · [Gson](https://github.com/google/gson)
- [DataStore](https://developer.android.com/topic/libraries/architecture/datastore)
- [Glance](https://developer.android.com/develop/ui/compose/glance) (widget)
- [WorkManager](https://developer.android.com/topic/libraries/architecture/workmanager) · [NanoHTTPD](https://github.com/NanoHttpd/nanohttpd)

## 📂 Project structure

```text
app/src/main/
├── assets/webserver/           # Self-contained browser page for the local webserver
├── res/
│   ├── font/google_sans_flex.ttf  # Bundled variable font (SIL OFL 1.1)
│   └── ...                         # Layouts, values, themes, app icon
└── java/dev/wolly/dsbmaterial/
    ├── api/
    │   └── DSBMobileAPI.kt       # API client for DSBmobile (GZIP/HTML parsing)
    ├── data/
    │   ├── DataStoreManager.kt   # Persistent storage for settings & credentials
    │   └── Models.kt             # Data classes for substitution entries
    ├── ui/
    │   ├── theme/                # Material 3 Theme, Color, Type, Shape, Motion
    │   ├── components/           # Shared UI components (sliders, buttons, layout)
    │   ├── screens/              # Home, Substitutions, Archive, Calendar, Settings,
    │   │                         # Theme picker, About, Share card, Debug mode, State screens
    │   └── MainViewModel.kt      # Business logic and UI state
    ├── AutoFetchWorker.kt        # Background auto-refresh of the substitution plan
    ├── LocalWebServer.kt         # NanoHTTPD server serving the plan over the local network
    ├── DSBWidget.kt / DSBWidgetReceiver.kt  # Home-screen widget
    ├── DSBApp.kt                 # Application class
    └── MainActivity.kt           # Main entry point and all Compose UI screens
```

## 🛠️ Building from source

1. **Clone the repository**
   ```bash
   git clone https://github.com/WollyDev24/DSBmaterial
   ```
2. **Open in Android Studio** — *Open an Existing Project*, select the cloned directory
3. **Sync and build** — let Gradle resolve dependencies, then *Build → Make Project*
4. **Run** — connect a device or start an emulator, then press *Run* ▶️

> Prefer the command line?
> ```bash
> ./gradlew assembleRelease
> ```

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a pull request.

1. Fork the repository
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

## ⭐ Special thanks

- [Tenner/dsbmobile](https://github.com/Tenner/dsbmobile) — understanding and usage of the DSBmobile API

## 📄 License

This project is licensed under the **Apache 2.0 License** — see the [LICENSE](LICENSE) file for details.
Third-party attributions are listed in the [NOTICE](NOTICE) file.

---

Made with ❤️ by [WollyDev24](https://github.com/wollydev24)

</div>

Astra

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Astra

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README