Metadata-Version: 2.1
Name: replaceapplemusic
Version: 0.0.1
Summary: A Python utility to replace source files of songs in Apple Music while preserving metadata
Home-page: https://github.com/realtvop/ReplaceAppleMusic
Author: realtvop
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: appscript
Requires-Dist: mutagen

# ReplaceAppleMusic

A Python utility to replace source files of songs in Apple Music while preserving metadata like play count, favorite status, and playlist memberships.

## Features

- Preserves play count
- Maintains favorite status
- Keeps playlist memberships
- Automatically removes old track after replacement

## Requirements

- macOS
- Python 3.x
- Apple Music app

## Installation

You can install it directly from PyPI:
```bash
pip install replaceapplemusic
```

Or install from source:
1. Clone this repository
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Make sure Apple Music is running and you have the necessary permissions

## Usage

```bash
# Replace a song
ramusic replace "Song Name" "Artist Name" "Album Name" "/path/to/new/file.mp3"

# Replace a song without specifying album
ramusic replace "Song Name" "Artist Name" "" "/path/to/new/file.mp3"

# Replace a song with only the title
ramusic replace "Song Name" "" "" "/path/to/new/file.mp3"
```
