Skip to content

Commit 46283d9

Browse files
committed
Release 1.3 Added essential configuration file to a new directory config.
1 parent 733639a commit 46283d9

2 files changed

Lines changed: 124 additions & 2 deletions

File tree

.gitignore

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,6 @@ Makefile
4242
data/
4343
playlists/
4444
logs/
45-
config/musiclib.conf
46-
config/*.confbak
4745

4846
# ----- Test output -----
4947
Testing/

config/musiclib.conf

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
# MusicLib System Configuration
2+
# System-wide defaults — do not edit this file directly.
3+
# To override settings, add them to: ~/.config/musiclib/musiclib.conf
4+
#
5+
# This configuration follows the XDG Base Directory Specification:
6+
# - Configuration files: ~/.config/musiclib/
7+
# - Application data: ~/.local/share/musiclib/
8+
#
9+
# IMPORTANT: This file is read both by bash (source) and by the Qt GUI's
10+
# ConfWriter parser. ConfWriter only understands simple KEY="value" lines.
11+
# Do NOT use bash conditionals (if/elif/fi), command substitution ($(...)),
12+
# or default-value syntax (${VAR:-default}) — the GUI cannot evaluate them.
13+
#
14+
# Shell variable references like $MUSICLIB_DATA_DIR are fine — the GUI's
15+
# variable resolver handles those via a layered lookup table.
16+
17+
#############################################
18+
# XDG BASE DIRECTORY DEFINITIONS
19+
#############################################
20+
21+
# These two lines must be absolute paths — everything else builds on them.
22+
MUSICLIB_XDG_CONFIG="$HOME/.config/musiclib"
23+
MUSICLIB_XDG_DATA="$HOME/.local/share/musiclib"
24+
25+
MUSICLIB_CONFIG_DIR="$MUSICLIB_XDG_CONFIG"
26+
MUSICLIB_DATA_DIR="$MUSICLIB_XDG_DATA"
27+
28+
#############################################
29+
# CORE PATHS
30+
#############################################
31+
32+
# Database location
33+
MUSICDB="$MUSICLIB_XDG_DATA/data/musiclib.dsv"
34+
35+
# Playlists directory
36+
PLAYLISTS_DIR="$MUSICLIB_XDG_DATA/playlists"
37+
MOBILE_DIR="$PLAYLISTS_DIR/mobile"
38+
CURRENT_PLAYLIST_FILE="$MOBILE_DIR/current_playlist"
39+
40+
# Musiclib log file
41+
LOGFILE="$MUSICLIB_XDG_DATA/logs/musiclib.log"
42+
43+
# Scripts directory
44+
SCRIPTS_DIR="/usr/lib/musiclib/bin"
45+
46+
#############################################
47+
# AUDACIOUS INTEGRATION
48+
#############################################
49+
50+
# Conky / now-playing output directory
51+
MUSIC_DISPLAY_DIR="$MUSICLIB_XDG_DATA/data/conky_output"
52+
53+
# Star rating images directory
54+
STAR_DIR="$MUSIC_DISPLAY_DIR/stars"
55+
56+
# Audacious playlists source directory (for playlist sync)
57+
AUDACIOUS_PLAYLISTS_DIR="$HOME/.config/audacious/playlists"
58+
59+
# Scrobble threshold (percentage of song that must play to count as "played")
60+
SCROBBLE_THRESHOLD_PCT=50
61+
62+
#############################################
63+
# MOBILE SYNC (KDE CONNECT)
64+
#############################################
65+
66+
# Mobile playlist settings
67+
MIN_PLAY_WINDOW=3600
68+
69+
# Days since last mobile upload before warning
70+
MOBILE_WINDOW_DAYS=40
71+
72+
#############################################
73+
# DATABASE SETTINGS
74+
#############################################
75+
76+
# Default database values for new tracks
77+
DEFAULT_RATING=0
78+
DEFAULT_GROUPDESC=0
79+
80+
# Database lock timeout (seconds)
81+
LOCK_TIMEOUT=10
82+
83+
#############################################
84+
# TAG MANAGEMENT
85+
#############################################
86+
87+
# Directory where tag backups are stored
88+
TAG_BACKUP_DIR="$MUSICLIB_XDG_DATA/data/tag_backups"
89+
90+
# Number of days tag backups are kept
91+
MAX_BACKUP_AGE_DAYS=30
92+
93+
#############################################
94+
# RATING SYSTEM (POPM VALUES)
95+
#############################################
96+
97+
# POPM (Popularimeter) is the ID3v2 frame used to store ratings
98+
# RATINGGROUP# = "LOW POPM,HIGH POPM"
99+
RatingGroup1="1,32"
100+
RatingGroup2="33,96"
101+
RatingGroup3="97,160"
102+
RatingGroup4="161,228"
103+
RatingGroup5="229,255"
104+
105+
#############################################
106+
# EXTERNAL DEPENDENCIES
107+
#############################################
108+
109+
# Command names (override in user config if using different paths/versions)
110+
EXIFTOOL_CMD="exiftool"
111+
KID3_CMD="kid3-cli"
112+
KDECONNECT_CMD="kdeconnect-cli"
113+
114+
#############################################
115+
# OPTIONAL DEPENDENCIES
116+
#############################################
117+
118+
# RSGAIN_INSTALLED: Set to "true" if rsgain is available, "false" otherwise
119+
# This controls whether the Boost Album feature is enabled in the GUI
120+
RSGAIN_INSTALLED=false
121+
122+
# Possible values: "kid3" (KDE version), "kid3-qt" (Qt standalone), or "none"
123+
# Note: kid3-cli (command-line) installed via the kid3-common package is a required dependency and always available
124+
KID3_GUI_INSTALLED="none"

0 commit comments

Comments
 (0)