id       = "vlc"
name     = "VLC media player"
homepage = "https://www.videolan.org/vlc/"
description = "A free and open source cross-platform multimedia player and framework."
icon     = "SimpleIcons:vlcmediaplayer"
# The Homebrew cask installs a `vlc` command wrapper around the app bundle's
# executable (Casks/v/vlc.rb, `command_wrapper "vlc"`), and the Linux packages
# ship the same name, so the binary is what a consumer sees rather than the
# bundle identifier.
executables   = ["vlc"]

[dotfiles]

# https://wiki.videolan.org/Preferences/ gives the preferences file per
# platform: "~/.config/vlc/vlcrc" on Linux/Unix — it was ~/.vlc/vlcrc before
# 0.9, long enough ago not to be worth naming — "~/Library/Preferences/
# org.videolan.vlc/vlcrc" on macOS, and "%appdata%\vlc\vlcrc" on Windows.
#
# macOS is the odd one out: a folder under ~/Library/Preferences rather than
# Application Support, which is [preferences]. Linux and Windows are one
# location under two names, which is [configHome] — VLC resolves the Unix side
# through XDG, so the placeholder picks up $XDG_CONFIG_HOME rather than
# hard-coding ~/.config. Windows spells the folder `vlc` in lower case there
# too, per the same page.
#
# The Mac interface also keeps an ordinary NSUserDefaults domain beside the
# folder: Casks/v/vlc.rb zaps both ~/Library/Preferences/org.videolan.vlc and
# ~/Library/Preferences/org.videolan.vlc.plist.
paths = [
  "[preferences]/org.videolan.vlc/vlcrc",
  "[preferences]/org.videolan.vlc.plist",
  "[configHome]/vlc/vlcrc",
]

exclude = []

# No credential file. The cask's zap list holds caches, HTTPStorages and saved
# application state beside the two preference locations, and nothing under the
# home directory that is a credential end to end.
secret = []

# No machine_lines. vlcrc is a flat INI of playback, audio, video and hotkey
# settings — the things a user wants on the next machine — and the Mac domain
# beside it is a property list, which this schema has no matcher for.