Home

Awesome

phiola

phiola - fast audio player, recorder, converter for Windows, Linux & Android. It can play audio files from your device or remote server, record audio from your microphone or Internet radio stream, process and convert audio into another format, and more. Its low CPU consumption conserves the notebook/phone battery. You can issue commands to phiola via its CLI, TUI, GUI, system pipe and SDK interfaces. Its fast startup time allows using it from custom scripts on a "play-and-exit" or "record-and-exit" basis. It's completely portable (all codecs are bundled) - you can run it directly from a read-only flash drive. It's a free and open-source project, and you can use it as a standalone application or as a library for your own software.

Screenshots of phiola GUI on Android, KDE/Linux and Windows 10: phiola GUI on Android, KDE/Linux and Windows 10

Contents:

Features

Bonus: Convenient API with plugin support which allows using all the above features from any C/C++/Java app!

Features and notes by platform:

FeatureLinuxWindowsAndroid
GUI
Dark themed GUI✅ (GTK default)incomplete
Powerful CLI
Simple TUI
Playback formats✅ all supported✅ all supportedall supported except .mpc, .ape, .wv
Conversion formats✅ all supported✅ all supportedall supported except .mpc, .ape, .wv
Batch conversion
Record from mic
Record from Internet
Record what you hear✅ (PulseAudio)
Requirementsglibc-2.31(AMD64), glibc-2.36(ARM64)Windows 7Android 8 (ARM64), Android 6 (ARM)
HW RequirementsAMD64, ARM64AMD64ARM64, ARM(incomplete)

Although not officially supported, phiola should build fine for macOS, FreeBSD and Windows XP after tweaking the build script.

See also: phiola Architecture.

Install

Download the latest package for your OS and CPU from phiola Releases

Linux

For example, here's how you can install the latest release for AMD64 into ~/bin directory:

wget https://github.com/stsaz/phiola/releases/download/v2.2.5/phiola-2.2.5-linux-amd64.tar.zst
mkdir -p ~/bin
tar xf phiola-2.2.5-linux-amd64.tar.zst -C ~/bin
ln -s ~/bin/phiola-2/phiola ~/bin/phiola
cp ~/bin/phiola-2/mod/gui/phiola.desktop ~/.local/share/applications

If you choose another directory rather than ~/bin, then you should also edit Icon= value in ~/.local/share/applications/phiola.desktop.

Windows

The easiest way to install phiola on Windows is to execute phiola-...-windows-x64-setup.exe and specify the installation directory.

Another option is to manually unpack phiola-...-windows-x64.zip and add phiola directory to your PATH environment.

Android

Install from IzzyOnDroid:

<p><a href="https://apt.izzysoft.de/packages/com.github.stsaz.phiola"><img src="https://github.com/stsaz/phiola/raw/resources/IzzyOnDroid.png" height="117px"></a></p>

Or install .apk manually:

Or you can install .apk file from the PC connected to your phone with adb install.

How to Use CLI

Important: enclose in quotes the file names containing spaces or special characters, e.g.: phiola play "My Music"; phiola play "My Recordings" -include "*.wav".

Play:

# Play files, directories and URLs
phiola play file.mp3 *.flac "My Music" http://server/music.m3u
# or just
phiola file.mp3 *.flac "My Music" http://server/music.m3u

# Play all files within directory in random order and auto-skip the first 20 seconds from each track
phiola "My Music" -random -seek 0:20

# Play on Linux directly via ALSA (and not PulseAudio)
phiola file.mp3 -audio alsa

# Play Internet radio and save the tracks as local files.
# These files will be named automatically using the meta data sent by server.
phiola http://server/stream -tee "@artist - @title.mp3"

# Play MP3 audio via HTTP and convert to a local 64-kbit/sec AAC file
phiola http://server/music.mp3 -dup @stdout.wav | phiola convert @stdin -aac_q 64 -o output.m4a

While audio is playing, you can control phiola via keyboard. The most commonly used commands are:

KeyAction
SpacePlay/Pause
Right ArrowSeek forward
nPlay next track
pPlay previous track
qQuit
hShow all supported commands

Record:

# Record from the default audio device until stopped
phiola record -o audio.flac

# Record for 1 minute, then stop automatically
phiola record -o audio.flac -until 1:0

# Record and set meta data
phiola record -meta "artist=Great Artist" -o audio.flac

# Record to the automatically named output file
phiola record -o @nowdate-@nowtime.flac

# Record with a specific audio format
phiola record -aformat int16 -rate 48000 -channels 2 -o audio.flac

# Record what is currently playing on your system ("what you hear")
# * WASAPI:
phiola record -loopback -o audio.flac
# * PulseAudio:
phiola record -dev `phiola dev list -f Monitor -n` -o audio.flac

# Start recording in background, then stop recording from another process:
#   Step 1: record while listening for system-wide commands
phiola -Background record -o audio.flac -remote
#   Step 2: send 'stop' signal to the phiola instance that is recording audio
phiola remote stop

# Record and split the output files by 1 hour
phiola record -split 1:00:00 -o @nowdate-@nowtime.flac

# Record and pass the audio through Dynamic Audio Normalizer filter
phiola record -danorm 'frame 500 size 15' -o audio.flac

# Record and pass the audio to another program
phiola record -o @stdout.wav | your_program

Note: the output audio format is chosen automatically by the file extension you specify.

Note: it's not required to always type the whole name of a command or an option - you may type just its prefix (enough for phiola to recognize it), e.g. instead of phiola record -aformat int16 you may type phiola rec -af int16.

Convert:

# Convert
phiola convert audio.flac -o audio.m4a

# Convert with parameters
phiola convert file.mp3 -aformat int16 -o file.wav
phiola convert file.wav -vorbis_q 7 -o file.ogg
phiola convert file.wav -rate 48000 -aac_q 5 -o file.m4a

# Convert multiple files from .wav to .flac
phiola convert *.wav -o .flac

# Convert all .wav files inside a directory,
#  preserving the original file names and file modification time
phiola convert "My Recordings" -include "*.wav" -o @filepath/@filename.flac -preserve_date

# Copy (without re-encoding) MP3 audio region from 1:00 to 2:00 to another file
phiola convert -copy -seek 1:0 -until 2:0 input.mp3 -o output.mp3

# Extract (100% accurately) several tracks from a .cue file
phiola convert input.cue -tracks 3,7,13 -o "@tracknumber. @artist - @title.flac"

# Increase .wav file's volume by 6 dB
phiola convert file.wav -gain 6 -o file-louder.wav

Note: the output audio format is chosen automatically by the file extension you specify.

Show file info:

# Show meta info on all .wav files inside a directory
phiola info "My Recordings" -include "*.wav"

# Show meta info including all tags
phiola info -tags file.mp3

# Search for the .mp3 files containing a specific tag
phiola info -tags -inc "*.mp3" . | grep -B10 "Purple Haze"

# Analyze and show PCM info
phiola info -peaks file.mp3

Other use-cases:

# List all available audio playback and recording devices
phiola device list

# Replace/add MP3 tags in-place
# WARNING: please test first before actually using on real files (or at least make backups)!
phiola tag -m "artist=Great Artist" -m "title=Cool Song" file.mp3

# Create a playlist from all .mp3 files in the directory
phiola list create "My Music" -include "*.mp3" -o my-music.m3u

# Sort entries (by file name) in all playlists in the current directory
phiola list sort *.m3u

# Automatically correct the file paths inside playlist (e.g. after some files were moved)
phiola list heal Music/playlist.m3u

Currently supported commands:

CommandDescription
convertConvert audio
deviceList audio devices
guiStart graphical interface
infoShow file meta data
listProcess playlist files
playPlay audio
recordRecord audio
remoteSend remote command
tagEdit .mp3 file tags

For the details on each command you can click on the links above or execute phiola COMMAND -h on your PC.

See also: phiola Wiki

How to Use GUI

Start phiola GUI:

Then add some files to playlist via drag-n-drop from your File Manager, or via List->Add menu command.

Bonus: you can modify the appearance by editing the GUI source file: phiola-2/mod/gui/ui.conf. You can also modify the text by editing language files, e.g. phiola-2/mod/gui/lang_en.conf. Restart phiola GUI after you make changes to those files.

100% Portable Mode

By default, phiola GUI saves and restores its state (including your playlists) on each restart at these locations:

But in case you don't want this, then just create an empty [phiola directory]/mod/gui/user.conf file. As long as this file is present, phiola GUI will store its state there, and it won't touch anything inside your user directory.

How to Use on Android

First time start:

How to Use SDK

The best example how to use phiola software interface is to see the source code of phiola executor in src/exe, e.g. src/exe/play.h contains the code that adds input files into a playlist and starts the playback.

A short description of how phiola works:

External Libraries

phiola uses modified versions of these third party libraries: libALAC, libfdk-aac, libFLAC, libMAC, libmpg123, libmpc, libogg, libopus, libvorbis, libwavpack, libsoxr, libzstd, libDynamicAudioNormalizer. And these unmodified libraries: openssl. Many thanks to their creators for the great work!!! Please consider their licenses before commercial use. See contents of alib3/ for more info.

Additionally:

Build

Build Instructions

Bug report

If you encounter a bug, please report it via GitHub Issues. When filing a bug report try to provide enough information that can help the developers to understand and fix the problem.

When using CLI, additional debug messages may help sometimes - just add -D after phiola when executing a command, e.g.:

phiola -D play file.mp3

With phiola on Android, there's a button in "About" screen that will save system logs to a file. It will contain the necessary information about the last time phiola crashed, for example.

Why use phiola

phiola is not (and most likely will never be) a competitor to large commercial projects such as Winamp, but there are a few points where phiola is better:

License

phiola is licensed under BSD-2. But consider licenses of the third party libraries before commercial use. Playback control icons by Icons8.