ByeTunes - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #llm #golang #machine-learning #rust #docker #nodejs #java #kubernetes #ios

ByeTunes

(★ 385)

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.

File Explorer

Download Latest Version (.zip)

- - Contents.json
- BackendHealth.swift
- BackgroundAudioDownloadManager.swift
- BackgroundMetadataFetchManager.swift
- BackupRestoreView.swift
- Config.swift
- ContentView.swift
- DeviceLibraryBrowserView.swift
- DownloadLiveActivityManager.swift
- DownloadView.swift
- IDEVICE_FFI_BUILD.md
- iDeviceManager.swift
- Info.plist
- iTunesSearchSheet.swift
- LibraryRepairView.swift
- LinkNormalizer.swift
- Logger.swift
- LogViewer.swift
- LyricsSearchSheet.swift
- MaintenancePanelView.swift
- ManageBackupsView.swift
- ManualMetadataEditor.swift
- MediaLibraryBuilder.swift
- MetadataBackgroundURLSession.swift
- MusicManager.entitlements
- MusicManagerApp.swift
- MusicManagerIntents.swift
- MusicView.swift
- OnboardingView.swift
- PlaylistBackupSelectorSheet.swift
- PlaylistDetailView.swift
- QueuePersistence.swift
- RingtonesView.swift
- SettingsView.swift
- ShareSheetHelper.swift
- SongMetadata.swift
- SongRowView.swift
- SplashView.swift
- TabViews.swift
- TutorialOverlayView.swift
- - contents.xcworkspacedata
- project.pbxproj
- DownloadLiveActivityAttributes.swift
- DownloadLiveActivityWidget.swift
- Info.plist
- MusicManagerTests.swift
- MusicManagerUITests.swift
- MusicManagerUITestsLaunchTests.swift
.gitignore
LICENSE
README.md

# Installation Guide

1. Get the code

git clone https://github.com/EduAlexxis/ByeTunes

Downloads the entire project code from GitHub to your computer.

cd ByeTunes

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Downloads and runs the official install script in one line — this handles the full setup automatically.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

// 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*