Audio player
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1.7 KiB

This document covers the ditty configuration options and their defaults.

Options

  • --buffer-size Audio buffer size, defaults to 500ms.
  • --disable-autoplay Disable automatically playing the queue.
  • --disable-mouse Disable mouse support.
  • --layout Interface layout, defaults to main,queue,playing.
  • --restrict-library Restrict access to a folder and its subfolders.
  • --fd Write audio in WAV format to the specified file descriptor instead. This allows ditty to be used over ssh:
    • ssh ditty.rocketnine.space -t 'ditty --fd=2' 2> >(aplay --quiet)
    • Note: Writing to a file descriptor disables pause support.

Default keybindings

  • Select Enter
  • Pause Space
  • Queue Q
  • Delete from queue D
  • Clear queue Ctrl+U
  • Toggle focused list Tab
  • Browse items J/K, Down/Up and PageDown/PageUp
  • Previous track P
  • Next track N
  • Volume -/+/M
  • Refresh R
  • Toggle hidden folder visibility .
  • Browse parent folder and focus last Backspace
  • Exit Ctrl+C or Alt+Q

Default ~/.config/ditty/config.yaml

layout: main,queue,playing

volume: 100

remember: true

input:
  select:
    - 'Enter'
  pause:
    - 'Space'
  refresh:
    - 'r'
  queue:
    - 'q'
  delete:
    - 'd'
  clear-queue:
    - 'Ctrl+u'
  focus-next:
    - 'Tab'
  hidden-folders:
    - '.'
  browse-parent:
    - 'Backspace'
  volume-mute:
    - 'm'
  volume-down:
    - '-'
  volume-up:
    - '+'
    - '='
  previous-item:
    - 'Up'
    - 'k'
  next-item:
    - 'Down'
    - 'j'
  previous-page:
    - 'PageUp'
  next-page:
    - 'PageDown'
  previous-track:
    - 'p'
  next-track:
    - 'n'
  exit:
    - 'Alt+q'