iOpenPod

https://therealsavi.github.io/iOpenPod/
Admin
iOpenPod is an open-source iPod manager for Windows, macOS, and Linux that lets users manage media,...
Tokens:2,932
Snippets:57
Trust Score:9.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install and Run iOpenPod via Flatpak

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Commands to install the Flatpak bundle and launch the application.

```bash
flatpak install --user ./iOpenPod-Linux.flatpak
flatpak run io.github.therealsavi.iOpenPod
```

--------------------------------

### Install iOpenPod via pip

Source: https://therealsavi.github.io/iOpenPod

Installs iOpenPod into the current Python environment.

```bash
python -m pip install iopenpod
iopenpod
```

--------------------------------

### Install iOpenPod via uv tool

Source: https://therealsavi.github.io/iOpenPod

Installs iOpenPod using the uv tool for isolated app management.

```bash
uv tool install iopenpod
iopenpod
```

--------------------------------

### Install Linux Qt desktop libraries

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Install required XCB and XKB libraries to resolve crashes or errors related to keyboard modifiers on Linux distributions.

```bash
sudo apt install libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-xkb1 libxkbcommon0 libxkbcommon-x11-0
```

```bash
sudo dnf install libxcb xcb-util-cursor xcb-util-wm xcb-util-image xcb-util-keysyms xcb-util-renderutil libxkbcommon libxkbcommon-x11
```

```bash
sudo pacman -S libxcb xcb-util-cursor xcb-util-wm xcb-util-image xcb-util-keysyms xcb-util-renderutil libxkbcommon libxkbcommon-x11
```

--------------------------------

### Install and run iopenpod with pipx

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Commands to install, run, update, or remove iopenpod using the pipx package manager.

```bash
pipx install iopenpod
iopenpod
```

```bash
pipx upgrade iopenpod
pipx uninstall iopenpod
```

--------------------------------

### Verify Chromaprint fpcalc installation

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Check the installed version of fpcalc to ensure it is available for acoustic fingerprinting.

```bash
fpcalc -version
```

--------------------------------

### Verify helper tools

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Check if FFmpeg, ffprobe, and fpcalc are correctly installed.

```bash
ffmpeg -version
ffprobe -version
fpcalc -version
```

--------------------------------

### Verify FFmpeg and ffprobe installation

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Check the installed versions of FFmpeg and ffprobe to ensure they are available for media processing.

```bash
ffmpeg -version
ffprobe -version
```

--------------------------------

### Install FUSE for AppImage

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Install FUSE dependencies required to run the iOpenPod AppImage.

```bash
# Ubuntu / Debian
sudo apt install libfuse2

# Ubuntu 24.04 and newer may use this name
sudo apt install libfuse2t64

# Arch Linux
sudo pacman -S fuse2
```

--------------------------------

### Install iOpenPod via pipx

Source: https://therealsavi.github.io/iOpenPod

Creates an isolated environment for the iOpenPod application.

```bash
pipx install iopenpod
iopenpod
```

--------------------------------

### Install Linux Qt dependencies

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Install required Qt libraries on Debian or Ubuntu to resolve platform plugin errors.

```bash
sudo apt install libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-xkb1 libxkbcommon0 libxkbcommon-x11-0
```

--------------------------------

### Install iOpenPod with specific Python version

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Use this if your default Python version is older than 3.11.

```bash
pipx install --python python3.11 iopenpod
```

--------------------------------

### Uninstall iOpenPod

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Remove existing iOpenPod installations to resolve conflicts.

```bash
uv tool uninstall iopenpod
pipx uninstall iopenpod
python -m pip uninstall iopenpod
```

--------------------------------

### List installed Python versions on Windows

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Check available Python versions on Windows systems.

```cmd
py -0p
```

--------------------------------

### Initialize iOpenPod Development Environment

Source: https://therealsavi.github.io/iOpenPod

Commands to clone the repository and set up the local development environment using uv.

```bash
$ git clone https://github.com/TheRealSavi/iOpenPod.git
$ cd iOpenPod
$ _uv sync_
$ _uv run iopenpod_
```

--------------------------------

### Run iOpenPod on Wayland

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Force the Qt platform to Wayland for Linux desktops.

```bash
QT_QPA_PLATFORM=wayland iopenpod
```

--------------------------------

### Perform iPod write test

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Verify write permissions by creating and deleting a test file on the iPod.

```bash
touch "/path/to/iPod/.iopenpod-write-test"
rm "/path/to/iPod/.iopenpod-write-test"
```

--------------------------------

### Launch Linux AppImage

Source: https://therealsavi.github.io/iOpenPod

Commands to make the AppImage executable and launch it on Linux systems.

```bash
chmod a+x ./iOpenPod-Linux-x86_64.AppImage
./iOpenPod-Linux-x86_64.AppImage
```

--------------------------------

### Manually mount iPod with specific permissions

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Mount the iPod partition manually with user-specific ownership.

```bash
sudo umount "/path/to/iPod"
sudo mkdir -p /mnt/ipod
sudo mount -o rw,uid=$(id -u),gid=$(id -g),umask=022 /dev/sdXN /mnt/ipod
```

--------------------------------

### Remount iPod as read-write

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Remount the iPod partition with read-write permissions.

```bash
sudo mount -o remount,rw "/path/to/iPod"
```

--------------------------------

### Extract and Run iOpenPod Tarball on Linux

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Commands to extract the tarball and execute the application binary.

```bash
tar -xzf iOpenPod-Linux.tar.gz
cd iOpenPod
./iOpenPod
```

--------------------------------

### Check iPod mount status

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Verify if the iPod is mounted as read-only or read-write.

```bash
findmnt -T "/path/to/iPod"
lsblk -f
```

--------------------------------

### Update shell path for iOpenPod

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Run these commands if the iopenpod command is not recognized in your terminal.

```bash
# uv installs
uv tool update-shell

# pipx installs
pipx ensurepath
```

--------------------------------

### Repair FAT32 iPod partition

Source: https://therealsavi.github.io/iOpenPod/install-help.html

Unmount the iPod and run a filesystem check to repair errors.

```bash
sudo umount "/path/to/iPod"
sudo fsck.vfat -a /dev/sdXN
```
Tokens:
Raw