KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

ByeTunes

★ 383 Open GitHub ↗

The first app of its kind: seamless, on-device music and ringtone injection for iOS. Bypass iTunes and manage your native library directly. Auto-fetch metadata, organize playlists, and keep your files clean. The true local music experience is here.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ByeTunes 🎵

**Say goodbye to iTunes sync!**

ByeTunes is a native iOS app that lets you inject music (MP3, M4A, FLAC, WAV) and ringtones directly into your device's media library—without needing a computer connection for every sync. It communicates directly with the iOS media database, giving you the power to manage your music on your terms.

## Features

-   **Direct Music Injection**: Add songs to your Apple Music library without a PC.
-   (DISABLED FOR NOW) **Ringtone Manager**: Inject custom ringtones (`.m4r` and `.mp3` auto-conversion).
-   **Playlist Support**: Create and manage playlists on the fly.
-   **No Computer Needed** (after setup): Once paired, you're free!
-   **Metadata Editing**: Auto-fetched from iTunes or Deezer.

## Compilation Instructions

To build ByeTunes yourself, you'll need a Mac with Xcode.

### Prerequisites

1.  **Xcode**: Version 15+ recommended.
2.  **iOS Device**: Running iOS 16.0 or later.

### External Libraries

ByeTunes relies on `idevice` (a `libimobiledevice` alternative) to talk to the iOS internal file system. **These files are NOT included in this repository** for licensing/size reasons.

To compile the app, you need to obtain these two files and place them in the `MusicManager/` directory:

1.  `libidevice_ffi.a` (Static Library)
2.  `idevice.h` (Header File)

You can find idevice and compile it from here: [https://github.com/jkcoxson/idevice](https://github.com/jkcoxson/idevice)

*If you don't have these files, the project will not compile.*

### Build Steps

1.  Install Rust:
    ```bash
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    ```
2.  Add the ios Arch:
    ```bash
    rustup target add aarch64-apple-ios
    ```
    
3.  Install Xcode Command Line Tools if you don't have it already installed:
    ```bash
    xcode-select --install
    ```

4.  Clone the repo:
    ```bash
    git clone https://github.com/jkcoxson/idevice
    ```

5.  Set a deployment target:
    ```bash
    export IPHONEOS_DEPLOYMENT_TARGET=xx.x
    ```

6.  Run the cargo build:
    ```bash
    cargo build --release --package idevice-ffi --target aarch64-apple-ios
    ```
Inside the idevice folder find: idevice.h and libidevice_ffi.a. Move them inside the project in Xcode, make sure you create **Bridging-Header.h**
Inside your Xcode project and make sure you add:

```bash
    #import "idevice.h"
```

**In Project Settings > Build Phases > Link Binary With Libraries, make sure libidevice_ffi.a is listed.**

## How to Use

1. **LocalDevVPN**:
    - Download LocalDevVPN from the App Store/Altstore PAL https://apps.apple.com/us/app/localdevvpn/id6755608044.
    - Open it and tap Connect, you will need an active connection to import the pairing file inside the app.

2.  **Pairing**:
    -   On first launch, you'll see an "Import Pairing File" screen.
    -   You need to get a `pairing file`.
    -   Download idevice_pair refer to https://github.com/jkcoxson/idevice_pair .
    -   Generate you `pairing file`.
    -   Export it from your computer and Airdrop/Save it to your iPhone.
    -   Import it into ByeTunes.
      
3.  **Add Music**:
    -   Tap "Add Songs" and select files from your Files app.
    -   Hit "Inject to Device" and watch the magic happen.
      
4.  **Ringtones**:
    -   Go to the Ringtones tab, add your file, and inject!

## Notes

-   **Signed Apps**: If you install this via a signing service (Signulous, AltStore, etc.), the app includes a fix (`asCopy: true`) to ensure file importing works correctly without crashing.
-   **Backup**: Always good to have a backup of your music library before messing with database injection!

## Support & Bug Reporting

Found a bug? We'd love to fix it!

1.  **Report Issues**: Open a ticket on [GitHub Issues](https://github.com/EduAlexxis/ByeTunes/issues).
2.  **Join the Community**: Chat with us on [Discord](https://discord.gg/dDQ4P4SyKJ).
3.  **Attach Debug Logs**:
    *   If you are experiencing injection failures, please use the **Debug Options** under delte library inside settings.
    *   This includes a "Debug Logs" screen where you can copy the app logs.
    *   Please attach these logs to your issue report—they help us solve problems much faster!

---
*Created with ❤️ by EduAlexxis*

ByeTunes

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README