1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
// Copyright (C) 2026 Danilo M. <danix@danix.xyz>
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License version 2 as
// published by the Free Software Foundation.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
package notify
import (
"log"
"os"
"path/filepath"
"strings"
"github.com/godbus/dbus/v5"
)
// XDGSoundDirs is the sound theme search path: the user's dir then each data
// dir, the same roots as XDGIconDirs.
func XDGSoundDirs() []string {
dirs := XDGIconDirs()
for i, d := range dirs {
dirs[i] = filepath.Join(filepath.Dir(d), "sounds")
}
return dirs
}
var soundExts = []string{".oga", ".ogg", ".wav"}
// LookupSound resolves a sound naming spec name: the theme, its Inherits
// chain, then freedesktop, each searched across every root; within that, the
// full name first and then with trailing -components dropped, as the spec's
// fallback (message-new-email, message-new, message). "" when nothing matches.
func LookupSound(name, theme string) string {
// A name is a name, never a path: refuse what would walk out of the theme.
if strings.ContainsAny(name, "/\\") || strings.Contains(name, "..") {
return ""
}
roots := XDGSoundDirs()
var chain []string
seen := map[string]bool{}
for t := theme; t != "" && !seen[t]; {
seen[t] = true
chain = append(chain, t)
next := ""
// ponytail: only the first Inherits entry, as for icons; walk every
// parent if a multi-parent sound theme ever turns up.
for _, root := range roots {
if v := inheritsOf(filepath.Join(root, t)); v != "" {
next = v
break
}
}
t = next
}
if !seen["freedesktop"] {
chain = append(chain, "freedesktop")
}
for n := name; n != ""; {
for _, t := range chain {
for _, root := range roots {
for _, ext := range soundExts {
p := filepath.Join(root, t, "stereo", n+ext)
if fileExists(p) {
return p
}
}
}
}
i := strings.LastIndexByte(n, '-')
if i < 0 {
break
}
n = n[:i]
}
return ""
}
// SoundFromHints reads the three freedesktop sound hints. sound-file wins over
// sound-name, but only as an absolute path to a regular file: anything else
// is logged and treated as absent, so the name still gets its turn. silent is
// suppress-sound, published as is; the renderer decides what it means.
func SoundFromHints(hints map[string]dbus.Variant, theme string) (sound string, silent bool) {
if v, ok := hints["suppress-sound"]; ok {
silent, _ = v.Value().(bool)
}
if v, ok := hints["sound-file"]; ok {
if p, _ := v.Value().(string); p != "" {
// Regular only: a FIFO would block the player on open and a
// device like /dev/urandom would play noise.
if info, err := os.Stat(p); err == nil && filepath.IsAbs(p) && info.Mode().IsRegular() {
return p, silent
}
log.Printf("notifyd: sound-file %q is not an absolute path to a regular file", p)
}
}
if v, ok := hints["sound-name"]; ok {
if n, _ := v.Value().(string); n != "" {
return LookupSound(n, theme), silent
}
}
return "", silent
}
|