Skip to content

Clearing Content

The podkit device clear command removes content from an iPod without recreating the database. Use this when you want to remove tracks but keep the iPod database intact.

Basic Usage

Terminal window
# Clear all content from the default device
podkit device clear
# Clear a specific device
podkit device clear classic

Clearing Specific Content Types

You can target specific content types:

Terminal window
# Clear only music tracks
podkit device clear --type music
# Clear only video content
podkit device clear --type video
# Clear all content (default)
podkit device clear --type all
TypeWhat Gets Removed
musicAudio tracks and associated artwork
videoVideo files
allAll tracks and media files

Previewing with Dry Run

Preview what would be removed before committing:

Terminal window
podkit device clear --dry-run

This lists the tracks that would be deleted without actually removing anything.

Skipping Confirmation

By default, podkit asks for confirmation before clearing. To skip the prompt (useful for scripts):

Terminal window
podkit device clear --confirm

Clear vs Reset

device cleardevice reset
Removes tracksYesYes
Recreates databaseNoYes
Preserves database settingsYesNo
Use whenRemoving contentDatabase is corrupted or you want a fresh start

If you just want to remove tracks and re-sync, use clear. If the iPod database is in a bad state, use reset instead.

See Also