https://github.com/alexmercerind/audire

Identify music playing around you.
https://github.com/alexmercerind/audire

android kotlin material-3 material-design material-you music-recognition mvvm retrofit room views

Last synced: 8 days ago
JSON representation

Identify music playing around you.

• Host: GitHub
• URL: https://github.com/alexmercerind/audire
• Owner: alexmercerind
• License: gpl-3.0
• Created: 2023-10-26T13:26:39.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-01-18T14:41:02.000Z (10 months ago)
• Last Synced: 2024-05-01T22:52:02.785Z (6 months ago)
• Topics: android, kotlin, material-3, material-design, material-you, music-recognition, mvvm, retrofit, room, views
• Language: Kotlin
• Homepage:
• Size: 277 KB
• Stars: 159
• Watchers: 8
• Forks: 3
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


Audire


**🎵 Identify music playing around you.**

https://github.com/alexmercerind/audire/assets/28951144/3a6f22d9-899e-4a3e-980b-a869c1b61e50




  

    

    

    

  

  

    

    

    

  

## Download

- [GitHub Releases](https://github.com/alexmercerind/audire/releases/latest)

- [Google Play Store](https://play.google.com/store/apps/details?id=com.alexmercerind.audire)

- [IzzySoft](https://apt.izzysoft.de/fdroid/index/apk/com.alexmercerind.audire)

## Building

Refer to [CI](https://github.com/alexmercerind/audire/blob/main/.github/workflows/android.yml).

## Architecture

The project uses MVVM & [Android Architecture Components](https://developer.android.com/topic/architecture).

- UI

  - Activities & Fragments

    - MainActivity

    - MusicActivity

    - SettingsActivity

    - AboutActivity

    - IdentifyFragment

    - HistoryFragment

  - View Models

    - IdentifyViewModel

    - HistoryViewModel

    - SettingsViewModel

- Repositories

  - IdentifyRepository

  - HistoryRepository

  - SettingsRepository

- Data

  - Sources

    - IdentifyDataSource

        - ShazamIdentifyDataSource

        - AUDDIdentifyDataSource

        - ...

    - HistoryDataSource

  - Models & Entities

    - Music

    - HistoryItem

  - API: Retrofit

    - ShazamAPI

    - ShazamRetrofitInstance

    - AUDDAPI

    - AUDDRetrofitInstance

  - DB: Room

    - HistoryItemDao

    - HistoryItemDatabase

### Libraries

- [Coil](https://coil-kt.github.io/coil/)

- [Retrofit](https://square.github.io/retrofit/)

- [Room](https://developer.android.com/training/data-storage/room)

- ...

## How

#### Notes

1. ShazamIdentifyDataSource is based on:

    - https://github.com/marin-m/SongRec

    - https://github.com/alexmercerind/shazam-signature-jni

2. AUDDIdentifyDataSource is based on:

    - https://audd.io

3. ...

## License

![](https://github.com/alexmercerind/audire/assets/28951144/5546336a-fec9-431e-92af-a4619863d818)

This project & the work under this repository is governed by GNU General Public License v3.0.