---
name: "vagalumectl"
section: "1"
platform: "linux"
package: "vagalume"
version: "0.8.6-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/vagalumectl"
---

# vagalumectl(1)

Remotely control Vagalume via its D-Bus interface

## NAME

vagalumectl - Remotely control Vagalume via its D-Bus interface

## SYNOPSIS

**vagalumectl** *\[command\]*

## DESCRIPTION

This manual page documents briefly the **vagalumectl** command.

**vagalumectl** is a front end to easily control the Vagalume Last.fm client via its D-Bus interface without having to use low-level commands.

## COMMANDS

- **play**

  Start playing the last selected radio.

- **skip**

  Skip to the next song.

- **stop**

  Stop playing.

- **love**

  Mark the current song as 'loved'.

- **ban**

  Mark the current song as 'banned' and skip to the next one.

- **globaltag** *tag*

  Play a 'global tag' radio.

- **artist** *artist*

  Play a 'similar artists' radio.

- **group** *group*

  Play a 'Last.fm group' radio.

- **loved** *user*

  Play a user's 'loved tracks' radio.

- **mix** *user*

  Play a user's mix radio

- **neighbours** *user*

  Play a user's 'neighbours' radio.

- **library** *user*

  Play a user's library

- **playlist** *user*

  Play a user's playlist.

- **playurl** *url*

  Play an arbitrary radio URL.

- **volumeup** *\[inc\]*

  Increase playback volume. If *inc* is not specified it takes 5 as the default value. This command is not available on all platforms.

- **volumedown** *\[inc\]*

  Decrease playback volume. If *inc* is not specified it takes 5 as the default value. This command is not available on all platforms.

- **volume** *value*

  Set the playback volume to a specific value. This command is not available on all platforms.

- **start**

  Start Vagalume (unless already running).

- **close**

  Close Vagalume (unless already closed).

- **help**

  Show a quick reference of all available commands.

## EXAMPLES

Start playing the last selected radio:

  $ vagalumectl play

Play your loved tracks' radio:

  $ vagalumectl loved YOURUSERNAME

Play your best friend's playlist:

  $ vagalumectl playlist USERNAME

Please notice that quotes are recommended around parameters that might contain white spaces, such as **tag** or **artist** , e.g:

  $ vagalumectl tag "hard rock"\
   $ vagalumectl artist "Led Zeppelin"

## SEE ALSO

[**vagalume**(1)](/vagalume/1.md)

## AUTHOR

This manpage has been written by Mario Sanchez Prada \<msanchez@igalia.com\>