generate Ringtones.plist for custom iOS ring and alert tones

list custom tones in iOS settings by generating /Media/iTunes_Control/iTunes/Ringtones.plist

pip install ioscustomringtones

Instructions

1. convert audio files to .m4a, then rename to .m4r:

   ffmpeg -i some_tone.wav some_tone.m4a
   mv some_tone.m4a some_tone.m4r
   

2. mount the /Media/ directory of your iOS device to your local filesystem (this does not require a jailbroken device):

   mkdir ~/iPhone_Media/
   ifuse ~/iPhone_Media/
   

3. copy your .m4r files to ~/iPhone_Media/iTunes_Control/Ringtones/:

   cp ~/Music/Ringtones/*.m4r ~/iPhone_Media/iTunes_Control/Ringtones/
   

4. install ioscustomringtones with pip:

   pip install ioscustomringtones
   

5. pass the directory you mounted to the generate_ios_ringtones_plist command (see more options below):

   generate_ios_ringtones_plist ~/iPhone_Media/
   

    Usage: generate_ios_ringtones_plist [OPTIONS] MEDIA_DIRECTORY
   
    reads existing `.m4r` files in `/Media/iTunes_Control/Ringtones/` and
    writes `/Media/iTunes_Control/iTunes/Ringtones.plist` on an iOS
    device
   
   ╭─ Arguments ─────────────────────────────────────────────────────────╮
   │ *    media_directory      PATH  path to `/Media/` on the iOS device │
   │                                 [default: None]                     │
   │                                 [required]                          │
   ╰─────────────────────────────────────────────────────────────────────╯
   ╭─ Options ───────────────────────────────────────────────────────────╮
   │ --alerts-threshold                       INTEGER  number of seconds │
   │                                                   under which to    │
   │                                                   assume sound is   │
   │                                                   an alert tone vs  │
   │                                                   a ringtone        │
   │                                                   [default: 10]     │
   │ --binary              --no-binary                 whether to write  │
   │                                                   `.plist` in       │
   │                                                   binary format (as │
   │                                                   opposed to XML)   │
   │                                                   [default: binary] │
   │ --list-tones          --no-list-tones             print tones to    │
   │                                                   stdout            │
   │                                                   [default:         │
   │                                                   no-list-tones]    │
   │ --dryrun              --no-dryrun                 write to file;    │
   │                                                   otherwise print   │
   │                                                   to stdout         │
   │                                                   [default: dryrun] │
   │ --help                                            Show this message │
   │                                                   and exit.         │
   ╰─────────────────────────────────────────────────────────────────────╯
   

6. unmount the /Media/ directory from your local filesystem:

   sudo umount ~/iPhone/