Releases: doctorfree/RoonCommandLine
RoonCommandLine Version 2.1.4 Release 1
RoonCommandLine Release Notes
RoonCommandLine version 2.1.4 release 1 provides support for unattended installation.
- Set and export the
ROON_UNATTENDED
environment variable to perform an unattended installationexport ROON_UNATTENDED="unattended"
- Use
sudo -E ...
to install Debian or RPM format packages - Alternately,
./Install unattended
will also perform an unattended installation - After an unattended installation, execute
/usr/local/bin/roon -c discover
.
- This release checks and repairs the RoonCommandLine Python virtual environment
- Can occur if the system Python is upgraded and the previously installed Python is removed
- Typically this issue is restricted to Homebrew installs of Python
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.4-1.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.4-1.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release history
RoonCommandLine version 2.1.3 release 2 integrates the Roon Community Remote
GUI for Linux
- Add menu options to install, update, and open the Roon GUI
- Install
figlet
,gum
, andfzf
in postinstall - Add splash screen to menu open
RoonCommandLine version 2.1.3 release 1 provides support for specifying the default zone and last zone used
- Add usage to
get_zone_info
- Add
-P
flag tonow_playing
to list paused zones - Upgrade checks to prevent malformed
roon_api.ini
- Add
-z default
and-z last
to most commands to specify default or last zone used - Updated man pages
RoonCommandLine version 2.1.2 release 4 provides improved info and formatting for now playing and media search.
now_playing
info includes statenow_playing
output formatted withrich
if available- Fixes for upgrades on systems with
BSD sed
(e.g.macOS
) - Media search and selection enhancements
RoonCommandLine version 2.1.2 release 3 provides support for:
- Add signal handler to Python scripts
- Add tracks listing, track play and album track play commands
- Add
Examples
andUsage
to main menu - Install
jq
inmacInstall
- Improve info when selecting and listing in menus
- Improved
show_info()
RoonCommandLine version 2.1.2 release 2 provides support for:
- Installation and use of the
roon-tui
Roon terminal user interface- Install
roon-tui
withroon -I
- Open
roon-tui
withroon -O
- Install
- Add
roon-tui
wrapperroontui
- Add shortcuts to RoonCommandLine menus
- Add
list_album_tracks
command - Use
fzf
to fuzzy select and list media
RoonCommandLine version 2.1.1 release 1 provides support for shuffled artist/genre/playlist playback
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous releases added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with
now
argument - Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.3r2/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.1.4 Pre-Release 1
RoonCommandLine Release Notes
RoonCommandLine version 2.1.4 release 1 provides support for unattended installation
- Set and export the
ROON_USER
environment variable to specify the SSH user - Set and export the
ROON_UNATTENDED
environment variable to specify unattended installation
For example, to perform an unattended install on a Debian based system:
# Specify an unattended non-interactive install
export ROON_UNATTENDED=1
# Specify the SSH user (optional)
# If not specified, the last username found in /home will be used
export ROON_USER=myusername
# Perform the installation
sudo -E apt install ./RoonCommandLine_2.1.4-1.deb
After completing an unattended installation, in an interactive shell, execute the command:
/usr/local/bin/roon -c discover
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.4-1.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.4-1.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release history
RoonCommandLine version 2.1.3 release 2 integrates the Roon Community Remote
GUI for Linux
- Add menu options to install, update, and open the Roon GUI
- Install
figlet
,gum
, andfzf
in postinstall - Add splash screen to menu open
RoonCommandLine version 2.1.3 release 1 provides support for specifying the default zone and last zone used
- Add usage to
get_zone_info
- Add
-P
flag tonow_playing
to list paused zones - Upgrade checks to prevent malformed
roon_api.ini
- Add
-z default
and-z last
to most commands to specify default or last zone used - Updated man pages
RoonCommandLine version 2.1.2 release 4 provides improved info and formatting for now playing and media search.
now_playing
info includes statenow_playing
output formatted withrich
if available- Fixes for upgrades on systems with
BSD sed
(e.g.macOS
) - Media search and selection enhancements
RoonCommandLine version 2.1.2 release 3 provides support for:
- Add signal handler to Python scripts
- Add tracks listing, track play and album track play commands
- Add
Examples
andUsage
to main menu - Install
jq
inmacInstall
- Improve info when selecting and listing in menus
- Improved
show_info()
RoonCommandLine version 2.1.2 release 2 provides support for:
- Installation and use of the
roon-tui
Roon terminal user interface- Install
roon-tui
withroon -I
- Open
roon-tui
withroon -O
- Install
- Add
roon-tui
wrapperroontui
- Add shortcuts to RoonCommandLine menus
- Add
list_album_tracks
command - Use
fzf
to fuzzy select and list media
RoonCommandLine version 2.1.1 release 1 provides support for shuffled artist/genre/playlist playback
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous releases added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with
now
argument - Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.4r1/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.1.3 Release 2
RoonCommandLine Release Notes
RoonCommandLine version 2.1.3 release 2 integrates the Roon Community Remote
GUI for Linux
- Add menu options to install, update, and open the Roon GUI
- Install
figlet
,gum
, andfzf
in postinstall - Add splash screen to menu open
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.3-2.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.3-2.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release history
RoonCommandLine version 2.1.3 release 1 provides support for specifying the default zone and last zone used
- Add usage to
get_zone_info
- Add
-P
flag tonow_playing
to list paused zones - Upgrade checks to prevent malformed
roon_api.ini
- Add
-z default
and-z last
to most commands to specify default or last zone used - Updated man pages
RoonCommandLine version 2.1.2 release 4 provides improved info and formatting for now playing and media search.
now_playing
info includes statenow_playing
output formatted withrich
if available- Fixes for upgrades on systems with
BSD sed
(e.g.macOS
) - Media search and selection enhancements
RoonCommandLine version 2.1.2 release 3 provides support for:
- Add signal handler to Python scripts
- Add tracks listing, track play and album track play commands
- Add
Examples
andUsage
to main menu - Install
jq
inmacInstall
- Improve info when selecting and listing in menus
- Improved
show_info()
RoonCommandLine version 2.1.2 release 2 provides support for:
- Installation and use of the
roon-tui
Roon terminal user interface- Install
roon-tui
withroon -I
- Open
roon-tui
withroon -O
- Install
- Add
roon-tui
wrapperroontui
- Add shortcuts to RoonCommandLine menus
- Add
list_album_tracks
command - Use
fzf
to fuzzy select and list media
RoonCommandLine version 2.1.1 release 1 provides support for shuffled artist/genre/playlist playback
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous releases added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with
now
argument - Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.3r2/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.1.3 Release 1
RoonCommandLine Release Notes
RoonCommandLine version 2.1.3 release 1 provides support for specifying the default zone and last zone used
- Add usage to
get_zone_info
- Add
-P
flag tonow_playing
to list paused zones - Upgrade checks to prevent malformed
roon_api.ini
- Add
-z default
and-z last
to most commands to specify default or last zone used - Updated man pages
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.2-4.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.2-4.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release history
RoonCommandLine version 2.1.2 release 4 provides improved info and formatting for now playing and media search.
now_playing
info includes statenow_playing
output formatted withrich
if available- Fixes for upgrades on systems with
BSD sed
(e.g.macOS
) - Media search and selection enhancements
RoonCommandLine version 2.1.2 release 3 provides support for:
- Add signal handler to Python scripts
- Add tracks listing, track play and album track play commands
- Add
Examples
andUsage
to main menu - Install
jq
inmacInstall
- Improve info when selecting and listing in menus
- Improved
show_info()
RoonCommandLine version 2.1.2 release 2 provides support for:
- Installation and use of the
roon-tui
Roon terminal user interface- Install
roon-tui
withroon -I
- Open
roon-tui
withroon -O
- Install
- Add
roon-tui
wrapperroontui
- Add shortcuts to RoonCommandLine menus
- Add
list_album_tracks
command - Use
fzf
to fuzzy select and list media
RoonCommandLine version 2.1.1 release 1 provides support for shuffled artist/genre/playlist playback
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous releases added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with
now
argument - Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.2r4/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.1.2 Release 4
RoonCommandLine Release Notes
RoonCommandLine version 2.1.2 release 4 provides improved info and formatting for now playing and media search.
now_playing
info includes statenow_playing
output formatted withrich
if available- Fixes for upgrades on systems with
BSD sed
(e.g.macOS
) - Media search and selection enhancements
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.2-4.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.2-4.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release history
RoonCommandLine version 2.1.2 release 3 provides support for:
- Add signal handler to Python scripts
- Add tracks listing, track play and album track play commands
- Add
Examples
andUsage
to main menu - Install
jq
inmacInstall
- Improve info when selecting and listing in menus
- Improved
show_info()
RoonCommandLine version 2.1.2 release 2 provides support for:
- Installation and use of the
roon-tui
Roon terminal user interface- Install
roon-tui
withroon -I
- Open
roon-tui
withroon -O
- Install
- Add
roon-tui
wrapperroontui
- Add shortcuts to RoonCommandLine menus
- Add
list_album_tracks
command - Use
fzf
to fuzzy select and list media
RoonCommandLine version 2.1.1 release 1 provides support for shuffled artist/genre/playlist playback
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous releases added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with 'now' argument
- Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.2r4/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.1.1 Release 1
RoonCommandLine Release Notes
RoonCommandLine version 2.1.1 release 1 provides support for shuffled artist/genre/playlist playback
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
IMPORTANT NOTE Older versions of RoonCommandLine will no longer function properly. In order to use RoonCommandLine you must install version 2.0.2 release 1 or later.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.1-1.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.1-1.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release history
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous releases added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with 'now' argument
- Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.1r1/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.1.0 Release 6
RoonCommandLine Release Notes
RoonCommandLine version 2.1.0 release 6 provides a more robust Python virtual environment installation of pip
RoonCommandLine version 2.1.0 release 5 ensures that pip is installed in the Python virtual environment
RoonCommandLine version 2.1.0 release 4 adds the capability to transfer the current queue from one Roon zone to another
RoonCommandLine version 2.1.0 release 3 moves to a Python virtual environment to support Ubuntu 23.04, Debian 12, and later
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
IMPORTANT NOTE Older versions of RoonCommandLine will no longer function properly. In order to use RoonCommandLine you must install version 2.0.2 release 1 or later.
Download the latest Debian or RPM package format release from the Assets section below.
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.1.0-6.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.1.0-6.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://github.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Changelog
This release primarily adds support for installation on Ubuntu 23.04, Debian 12 and later in which a Python virtual environment is required.
The previous release added support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with 'now' argument
- Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.1.0r6/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.0.8 Release 5
RoonCommandLine Release Notes
RoonCommandLine version 2.0.8 release 5 is a minor bug fix release and provides PEP 8 conformance
RoonCommandLine version 2.0.8 release 4 is a minor bug fix release, only restore saved roon_api.ini
if in new format.
RoonCommandLine version 2.0.8 release 3 provides support for Homebrew installed Python and several bug fixes.
RoonCommandLine version 2.0.8 release 2 provided compatibility with volume handling changes in the Python Roon API. Volume change/setting can now be made using a percentage. This release also adds support for fading track play volume immediately with the roon_fade now
command along with Mac installation fixes.
RoonCommandLine version 2.0.7 release 1 was a minor feature and bugfix update. That release added support for fading track play volume and fixed possible stale authentication tokens.
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
IMPORTANT NOTE Older versions of RoonCommandLine will no longer function properly. In order to use RoonCommandLine you must install version 2.0.2 release 1 or later.
Download the latest Debian or RPM package format release
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.0.8-4.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.0.8-4.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://gitlab.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Changelog
This release adds support for:
- Check for python3 in roon set_default
- Support for Homebrew installed Python etc
- Don't error out in postinstall
- Postinstall fails when there is a directory in /home that is not a valid user
- Check if run as root user in Install
- Always upgrade roonapi during install
- Mac installation fixes
- Restore ensurepip in Mac install
- Fix permissions errors during Mac install
- Remove symlinks in /usr/local/bin in Mac uninstall
- Redirect stderr when invoking tput to set BOLD and NORMAL text
- In Linux and Mac manual install scripts, upgrade roonapi if installed
- Support percentage volume change using new roonapi methods
- Handle negative volume levels in roon_fade
- Compatibility with latest
roonapi
volume methods - Support for percentage volume change/setting
- Add immediate mode to roon_fade with 'now' argument
- Implement non-interactive immediate fading
- Add interactive menu system (
roon_fade -i
) - Set man permissions correctly in manual install scripts
Version 2.0.7 release 1 added support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.0.8r4/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
RoonCommandLine Version 2.0.7 Release 1
RoonCommandLine Release Notes
RoonCommandLine version 2.0.7 release 1 is a minor feature and bugfix update. This release adds support for fading track play volume and fixes possible stale authentication tokens.
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
IMPORTANT NOTE Older versions of RoonCommandLine will no longer function properly. In order to use RoonCommandLine you must install version 2.0.2 release 1 or later.
Download the latest Debian or RPM package format release
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.0.7-1.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.0.7-1.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://gitlab.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Changelog
This release adds support for:
- Save authentication token right after we get a RoonApi handle (bug fix)
- Add options to
roon
command for controlling fading - Add fade feature (
roon_fade
user command androon_faded
fade daemon) - Man pages for fading and new commands
- Fixes for
now_playing
,get_zone_volume
, andget_zone_attributes
- Add
get_zone_remaining
to get remaining time for now playing in zone - Add
get_zone_volume
andget_zone_attributes.py
View the full changelog for this release at https://github.com/doctorfree/RoonCommandLine/blob/v2.0.7r1/CHANGELOG.md
See CHANGELOG.md for a full list of changes in every RoonCommandLine release
Roon Command Line version 2.0.6 release 2
RoonCommandLine Release Notes
RoonCommandLine version 2.0.6 release 2 is a minor feature update. This release adds support for listing a playlist's tracks.
Installation
The installation automatically detects and stores the Roon Core IP and port. There is no need for any manual configuration.
IMPORTANT NOTE Older versions of RoonCommandLine will no longer function properly. In order to use RoonCommandLine you must install version 2.0.2 release 1 or later.
Download the latest Debian or RPM package format release
Install the package on Debian based systems by executing the command
sudo apt install ./RoonCommandLine_2.0.6-2.deb
Install the package on RPM based systems by executing the command
sudo yum localinstall ./RoonCommandLine-2.0.6-2.rpm
Removal of the package on Debian based systems can be accomplished by issuing the command:
sudo apt remove rooncommandline
Removal of the package on RPM based systems can be accomplished by issuing the command:
sudo yum remove RoonCommandLine
To install on Mac OS X or a Linux system without support for Debian or Red Hat installation packages, clone the repository and execute the Install
command:
git clone https://gitlab.com/doctorfree/RoonCommandLine.git
cd RoonCommandLine
./Install
Release History
RoonCommandLine version 2.0.5 release 4 adds support for:
- Verify syntax of
pyroonconf
before sourcing - Restore corrupted
pyroonconf
to sensible defaults
The syntax verification and correction of /usr/local/Roon/etc/pyroonconf
is currently only performed when the roon
front-end is executed. If the backend RoonCommandLine utilities are invoked directly then the integrity of the pyroonconf
configuration file is the responsibility of the user.
RoonCommandLine version 2.0.5 release 3 added support for:
- Check status of return from set_zone and set_zone_group and exit on failures
- Adjust display height of some screenshots
- Do not assume project was cloned in HOME/src/RoonCommandLine
- Update usage message with now playing examples
- Add scripted Linux install note to release notes
- Quote zone name with info options
RoonCommandLine version 2.0.5 release 2 added support for:
- A
now_playing
command and roon command-n
option to retrieve now playing info for specified zone or all Roon zones - A
linInstall
script to perform scripted Linux install when no package available - When playing media by artist, composer, or in genre and no album or track is specified, use first in all matching
- If no search term provided, list commands list all rather than default
- Use sudo when upgrading in macInstall
- Save and restore pyroonconf on upgrades
- Added Size field to Debian control file
- Add play_all and stop_all commands
RoonCommandLine version 2.0.5 release 1 adds upgrade features, zone info, and commands.
This release preserves existing configuration if it detects a previous release of RoonCommandLine is already installed. Only the Roon Core IP and port are reconfigured if necessary. In addition, the default zone groupings in roon_api.ini
are improved to avoid grouping incompatible zones. Python scripts utilizing the Roon API have been improved to remove all warnings and use a single source for providing the extension version to Roon.
Changes to RoonCommandLine commands include changing the shuffle
and repeat
commands to toggles, similar to what was done for mute
. Note that repeat
does not mimic the Roon loop
feature which cycles through three values - 'loop', 'loop_one', and 'disabled'. The repeat
command in RoonCommandLine and the Python Roon API is a Boolean and toggles between 'loop' and 'disabled'.
A mute_all
command was added to toggle playback muting in all Roon zones.
A pause_all
command was added to pause playback in all Roon zones.
A play_all
command was added to begin playback in all Roon zones.
A stop_all
command was added to stop playback in all Roon zones and release devices.
A -i
option was added to the roon
command to display zone information. In the absence of any -z zone
argument, information on all zones is displayed. If a zone is specified in combination with the -i
argument, e.g. -i -z Kitchen
, then extended information is displayed for that zone alone. The Python script zone_properties.py
was added to support this feature.
RoonCommandLine version 2.0.4 release 3 is a feature modification release.
This release changes the mute/unmute commands to a toggle. Both commands operate exactly the same, toggling the muting/unmuting of the selected zone or zone grouping. The two commands are retained rather than removing unmute
in order to preserve compatibility with any existing scripts that use these commands.
RoonCommandLine version 2.0.4 release 2 is a bugfix release.
This release fixes a bug with muting/unmuting ungrouped zones.
RoonCommandLine version 2.0.4 release 1 adds zone and zone grouping volume control.
The command `roon -v volume` sets the volume level in the selected zone.
The `volume` argument has the format `[g:][r:][s:]num`
Where `g` indicates set volume for all zones in the group
`r` specifies use relative method volume setting
`s` specifies use relative_step method volume setting
`num` can be absolute (0-100) or relative (negative or positive)
RoonCommandLine version 2.0.3 release 2 adds several new commands including support for playing a specified track by artist, playing a specified album by artist, playing either a specified artist or album in designated genre, playing a specified composer, and additional listing options. Listing and playing commands now include support for artist and album name exclusion strings allowing searches for a specified artist/album/composer/genre/playlist whose name includes a specified string but not another string. This exclusion filtering enables narrower listing, searching, and playing of library media.
Checks for Python 3 and Pip have been added to pre-installation scripts, MacOS installation has been significantly improved, installation of the roonapi Pip module is handled more gracefully.
RoonCommandLine version 2.0.x releases add support for detection of the Roon Core port as well as its IP address. The port number is stored in roon_api.ini
and used in all subsequent calls to the Python Roon API. This was necessary as Roon Labs changed the port number in the most recent update. Extensions shouldn't be assuming a hard coded port number anyway so this change prompted a good improvement although it was irritating at first. A bug introduced by the change to return status of the Bash builtin type command was addressed. RoonCommandLine commands' location are added to PATH or full path used in SSH invocations. The installation script has been revised to work with the updated Python roonapi module version numbering. SSH invocations should work in a wider range of environments with this release.