AirLyrics

KO | EN

gitlite — search

#typescript #llm #golang #machine-learning #nodejs #awesome #cli #vue #pytorch #security #ios #mcp #openai #open-source

(★ 27)

An open-source Android floating lyrics app with synced LRC support for many music apps. 开源 Android 悬浮窗歌词，支持多种音乐 App 与同步 LRC。

AirLyrics 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

<img src="docs/assets/airlyrics-logo.png" width="120" alt="AirLyrics Logo" />

# AirLyrics

A lightweight Android floating lyrics app that detects current media playback and shows synced
lyrics in a customizable floating window.

[English](README.md) · [简体中文](README.zh-CN.md)

<br />

[Download](https://github.com/AirLyrics/AirLyrics/releases) · [Documentation](docs/README.md) ·
[Privacy](PRIVACY.md) · [Report Bug](https://github.com/AirLyrics/AirLyrics/issues)

<br />

[![Platform](https://img.shields.io/badge/platform-Android-brightgreen?style=flat-square)]()
[![Kotlin](https://img.shields.io/badge/Kotlin-Android-blueviolet?style=flat-square)]()
[![Rust](https://img.shields.io/badge/Rust-lyrics--core-orange?style=flat-square)]()
[![Release](https://img.shields.io/github/v/release/AirLyrics/AirLyrics?style=flat-square)](https://github.com/AirLyrics/AirLyrics/releases)

</div>

---

<div align="center">

<img src="docs/assets/screenshot-floating-lyrics.jpg" width="720" alt="AirLyrics floating lyrics" />

</div>

---

## Status

AirLyrics is stable and actively maintained.

The current release is intended for daily use. Future updates will mainly focus on bug fixes,
compatibility improvements, documentation updates, and reviewing issues or pull requests.

Compatibility may still vary depending on Android version, device manufacturer and music app.

---

## Quick Start

1. Install AirLyrics (Android 8.0 or later).
2. Grant the required permissions.
3. Manually select the current media source.
4. Open **Floating**, then tap **Show** in the bottom bar.

For detailed setup and troubleshooting, see the [User Guide](docs/USER_GUIDE.md).

---

## Features

- Detects current media playback and shows synced lyrics over other apps
- Searches lyrics online and imports local LRC files
- Supports original, translated, and locally imported word-by-word lyrics
- Customizable floating window styles and animations
- Saves lyrics offsets for each song
- Supports light and dark themes

---

## Screenshots

<div align="center">

<table>
  <tr>
    
    <td align="center">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.jpg" width="240" alt="Media detection settings" />
      <br />
      <sub>Media</sub>
    </td>
    
    <td align="center">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.jpg" width="240" alt="Floating lyrics appearance settings" />
      <br />
      <sub>Floating Appearance</sub>
    </td>
    
    <td align="center">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.jpg" width="240" alt="Floating lyrics controls and behavior settings" />
      <br />
      <sub>Floating Controls</sub>
    </td>
  </tr>
  <tr>
    
    <td align="center">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.jpg" width="240" alt="Current lyrics and search settings" />
      <br />
      <sub>Current Lyrics</sub>
    </td>
    
    <td align="center">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/5.jpg" width="240" alt="Lyrics sources, storage, and local library settings" />
      <br />
      <sub>Lyrics Library</sub>
    </td>
    
    <td align="center">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/6.jpg" width="240" alt="Lyrics editor with format validation and save controls" />
      <br />
      <sub>Lyrics Editor</sub>
    </td>
  </tr>
  <tr>
    
    <td align="center" colspan="3">
      
      <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/7.jpg" width="240" alt="System integration settings" />
      <br />
      <sub>System Settings</sub>
    </td>
  </tr>
</table>

<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/8.jpg" width="720" alt="AirLyrics notification and media controls" />
<br />
<sub>Notification Controls</sub>

</div>

---

## Permissions

AirLyrics uses these Android permissions and system access points:

| Permission / access     | Purpose                                           |
|-------------------------|---------------------------------------------------|
| Display over other apps | Shows the floating lyrics window                  |
| Notification access     | Detects current media playback                    |
| Notifications           | Shows foreground-service controls                 |
| Internet access         | Searches lyrics online                            |
| File picker             | Imports local lyrics files and selects a save folder |

See [Privacy Policy](PRIVACY.md) for details about permissions, local data and online lyrics search.

---

## Documentation

Project documentation is in the docs directory.

| Document                               | Description                                                    |
|----------------------------------------|----------------------------------------------------------------|
| [Documentation Home](docs/README.md)   | English documentation index                                    |
| [Privacy Policy](PRIVACY.md)           | Permissions, local data and online lyrics search privacy notes |
| [User Guide](docs/USER_GUIDE.md)       | Project usage guide                                            |
| [Lyrics Format](docs/LYRICS_FORMAT.md) | Local import, normal LRC and word-by-word lyrics format        |
| [Contributing](docs/CONTRIBUTING.md)   | Development environment, PR workflow and code locations        |
| [Architecture](docs/ARCHITECTURE.md)   | Module layout and runtime flow                                 |

---

## Build From Source

### Requirements

- JDK 17
- Android SDK
- Android NDK `26.3.11579264` required
- Rust stable via `rustup`
- `cargo-ndk`
- Rust Android target:
  - `aarch64-linux-android` is required for the default `arm64-v8a` build
- Optional Rust Android target:
  - `x86_64-linux-android` is only needed when building with `-Pairlyrics.buildX86_64=true`

Android Studio is recommended when configuring Android SDK related settings.

### Clone

```bash
git clone https://github.com/AirLyrics/AirLyrics.git
cd AirLyrics
```

### Build

```bash
./gradlew assembleDebug
```

The APK will be generated under:

```txt
app/build/outputs/apk/debug/
```

---

## Contributing

Contributions are welcome. AirLyrics is stable and actively maintained, so small and focused
changes are preferred.

Good areas to contribute:

- Bug reports
- Compatibility testing
- Translation improvements
- Documentation improvements
- UI text polishing

Contribution guide: [CONTRIBUTING.md](docs/CONTRIBUTING.md).

---

## Credits

- [waylyrics](https://github.com/waylyrics/waylyrics)

---

## License

AirLyrics is licensed under the MIT License.

See [LICENSE](LICENSE).

AirLyrics

AirLyrics 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

AirLyrics

AirLyrics 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README