Modello di stringa personalizzato di Symfonium

Questa pagina documenta la sintassi dei modelli di stringa personalizzati di Symfonium e gli elenchi di campi disponibili in ogni contesto.

È organizzata nelle sezioni seguenti:

• Sintassi comune dei modelli: segnaposto, blocchi condizionali, condizioni e operatori, formattazione del testo, regole di escape ed etichette globali localizzate string.*.
• Sezioni specifiche del contesto:
  • Riproduzione in corso: funzioni aggiuntive (\t, \o, campi next. e campi chapter.*) ed elenco completo dei campi di Riproduzione in corso.
  • Sottotitolo dell’album: campi a livello di album disponibili nelle pagine degli album.
  • Sottotitolo dell’artista: campi a livello di artista disponibili nelle pagine degli artisti.

---

Sintassi comune dei modelli (funziona ovunque)

Segnaposto di base

Sintassi: %fieldname%

• Sostituisce %fieldname% con il valore del campo.
• Se il campo è vuoto o mancante, non viene mostrato nulla.

Esempi:

Modello	Risultato di esempio
%title% by %artist%	Seven Nation Army di The White Stripes
%album% (%year%)	Thriller (1982)
%composer% ● %artist%	Ludwig van Beethoven ● Berliner Philharmoniker
%artist%%lb%%composer%	Berliner Philharmoniker

%lb% è un’interruzione di riga.

---

Blocchi condizionali

Usa i blocchi per mostrare punteggiatura o etichette solo quando esiste un valore o una condizione è soddisfatta.

Sintassi: { ... }

• Un blocco { ... } viene mostrato solo se il primo segnaposto corrisponde:
  • a un campo non vuoto;
  • oppure a un segnaposto di condizione vera (%|condition%).
• Puoi includere più segnaposto e testo letterale nello stesso blocco { ... }, ma solo il primo segnaposto determina se il blocco viene mostrato.
• Inserisci gli spazi necessari all’interno del blocco, ad esempio { by %artist%}.

Blocco condizionale basato su un campo

Esempi:

Modello	Risultato di esempio	Se il campo è vuoto
%title%{ by %artist%}	Seven Nation Army di The White Stripes	Seven Nation Army
%album%{ (%year%)}	Thriller (1982)	Thriller
{%composer% ● }%artist%	Beethoven ● Berliner Philharmoniker	Berliner Philharmoniker

Blocco condizionale basato su una condizione

Usa %|condition% come primo segnaposto per controllare un blocco senza visualizzare un valore.

Esempio:

{%|format.samplerate>"48"% Hi-Res: %format.codec%}

Mostra Hi-Res: FLAC solo se format.samplerate > 48.

Interruzioni di riga all’interno di { ... }

Usa \n nei blocchi condizionali:

%album%{\n(%year%)}

All’esterno di { ... }, usa preferibilmente %lb% per le interruzioni di riga.

---

Condizioni nei segnaposto

Sintassi: %field|condition%

Mostra il campo solo se la condizione è vera.

Puoi confrontare:

• il nome di un altro campo, ad esempio artist, composer o year;
• una stringa o un numero letterale tra virgolette, ad esempio "2012", "Rock" o "256".

Note sui valori letterali:

• track indica il campo track.
• "track" indica il testo letterale track.
• Le virgolette possono comparire nei valori. Assicurati che il valore letterale inizi e termini con ".

Esempi:

%year|year>"2012"%
%composer|composer!=artist%
%composer|genre=="Classical"%

---

Operatori

Operatore	Significato	Esempio	Note
==	uguale a	genre=="Classical" / artist==composer
!=	diverso da	artist!="Metallica"
+=	contiene	genre+="Rock"	funziona con un valore letterale o un altro campo
-=	non contiene	mood-="depressing"
>	maggiore di	year>"1999"	usa le virgolette per i numeri letterali
<	minore di	duration<"500"	la durata è espressa in secondi
==empty	è vuoto	year==empty	empty è riservato
!=empty	non è vuoto	composer!=empty	empty è riservato
[]	nell’intervallo	bpm[]"0".."100"	limiti inclusivi

---

Più condizioni, combinazioni di && / || e parentesi

• Usa && per AND.
• Usa || per OR.
• Puoi combinare && e || nella stessa condizione.
• Usa le parentesi (...) per controllare la priorità di valutazione.

Esempio:

%format|format.bitdepth!=empty && (format.samplerate>"48" || format.bitdepth>"24")%

Questo mostra %format% solo quando esiste la profondità in bit e almeno una delle condizioni seguenti è vera:

• la frequenza di campionamento è maggiore di 48;
• la profondità in bit è maggiore di 24.

---

Marcatori di formattazione del testo in linea

**Bold**
__Underline__
~~Strike~~
//Italics//
^^CAPS^^

---

Etichette localizzate (string.*)

Questi segnaposto restituiscono stringhe tradotte nella lingua dell’utente:

• string.hires
• string.lossless
• string.lossy
• string.hires.lossless
• string.low.quality
• string.high.quality
• string.high.efficiency
• string.time.unit.day.short
• string.time.unit.hour.short
• string.time.unit.minute.short
• string.time.unit.second.short
• string.time.unit.day.one
• string.time.unit.day.other
• string.time.unit.hour.one
• string.time.unit.hour.other
• string.time.unit.minute.one
• string.time.unit.minute.other
• string.time.unit.second.one
• string.time.unit.second.other
• string.track.one
• string.track.other
• string.album.one
• string.album.other

---

Riproduzione in corso (compatta ed espansa)

I modelli di Riproduzione in corso possono accedere a:

• metadati della traccia;
• stato della riproduzione;
• stato della coda;
• stato dei capitoli;
• formato audio;
• informazioni su EQ e renderer;
• altri dati.

Funzioni disponibili solo in Riproduzione in corso

Suddividere in più segmenti con \t

Usa \t per suddividere un modello in più segmenti.

Esempio:

%player.position%\t%format%\t%player.duration%

Con l’allineamento orizzontale distribuito, il risultato tipico è:

• a sinistra: posizione;
• al centro: formato;
• a destra: durata.

Overlay di protezione selettivo con \o

Usa \o per applicare un overlay di protezione solo a quella parte, anche se la stringa completa non è protetta.

Prefisso next.

Aggiungi next. prima dei campi dei dati dell’elemento per fare riferimento all’elemento successivo nella coda:

%next.title%

Per i campi dei capitoli, next.chapter.* fa riferimento al capitolo successivo.

---

Campi supportati (Riproduzione in corso)

Metadati di tracce e album

• title
• title.raw
• cleantitle (titolo senza numero di traccia aggiunto né simbolo di contenuto esplicito)
• artist
• album
• album.raw
• album.version
• album.type (noto anche come Release Type)
• albumartist
• album.tags
• album.title
• album.title.raw
• album.title.version
• composer
• year
• releasedate
• originaldate
• releasedate.year
• originaldate.year
• track
• disc
• disctitle
• duration
• duration.seconds (secondi totali)
• duration.d (aggiungi .nz per nascondere il valore se è zero)
• duration.h (aggiungi .nz per nascondere il valore se è zero)
• duration.m (aggiungi .nz per nascondere il valore se è zero)
• duration.s (aggiungi .nz per nascondere il valore se è zero)
• duration.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• bpm
• genre
• style
• mood
• occasion
• grouping
• language
• comment
• work
• movement.name
• movement.number
• movement.number.roman
• mediatype
• providername
• offlinestatus
• explicit
• favorite
• userrating
• rating
• userrating.5 (normalizzato su 5 stelle)
• rating.5 (normalizzato su 5 stelle)
• track.tags
• original.artist
• original.album
• filepath
• filename
• lastplayed
• lastSkipped
• isaudiobook
• playcount
• skipcount

Riproduzione / player

• player.position
• player.duration
• player.remaining
• player.position.seconds
• player.duration.seconds
• player.remaining.seconds
• player.paused
• player.repeat.mode
• player.shuffle.mode
• volume.current
• sleep.timer
• sleep.timer.seconds
• sleep.timer.eos

Coda / funzioni smart

• queue.position
• queue.size
• queue.name
• smartqueue
• smartflow
• radio.mode (1 se proviene da Coda smart, 2 o più se proviene da Smart Flow)

Capitoli

• chapter.count
• chapter.index
• chapter.title
• chapter.position
• chapter.position.seconds
• chapter.position.d (aggiungi .nz per nascondere il valore se è zero)
• chapter.position.h (aggiungi .nz per nascondere il valore se è zero)
• chapter.position.m (aggiungi .nz per nascondere il valore se è zero)
• chapter.position.s (aggiungi .nz per nascondere il valore se è zero)
• chapter.position.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.position.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.position.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.position.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.remaining
• chapter.remaining.seconds
• chapter.remaining.d (aggiungi .nz per nascondere il valore se è zero)
• chapter.remaining.h (aggiungi .nz per nascondere il valore se è zero)
• chapter.remaining.m (aggiungi .nz per nascondere il valore se è zero)
• chapter.remaining.s (aggiungi .nz per nascondere il valore se è zero)
• chapter.remaining.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.remaining.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.remaining.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.remaining.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.duration
• chapter.duration.seconds
• chapter.duration.d (aggiungi .nz per nascondere il valore se è zero)
• chapter.duration.h (aggiungi .nz per nascondere il valore se è zero)
• chapter.duration.m (aggiungi .nz per nascondere il valore se è zero)
• chapter.duration.s (aggiungi .nz per nascondere il valore se è zero)
• chapter.duration.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.duration.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.duration.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.duration.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.position
• chapter.all.position.seconds
• chapter.all.position.d (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.position.h (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.position.m (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.position.s (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.position.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.position.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.position.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.position.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.remaining
• chapter.all.remaining.seconds
• chapter.all.remaining.d (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.remaining.h (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.remaining.m (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.remaining.s (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.remaining.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.remaining.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.remaining.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.remaining.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.duration
• chapter.all.duration.seconds
• chapter.all.duration.d (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.duration.h (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.duration.m (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.duration.s (aggiungi .nz per nascondere il valore se è zero)
• chapter.all.duration.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.duration.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.duration.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• chapter.all.duration.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)

Formato / informazioni audio

• format
• format.bitrate
• format.bitrate.raw
• format.samplerate
• format.samplerate.raw
• format.bitdepth
• format.codec
• format.bitandsample
• format.channels

EQ / uscita / renderer

• eq.profile
• eq.config
• output.current
• renderer.current
• renderer.type

Utilità

• lb (interruzione di riga)
• bool1
• bool2
• bool3
• bool4
• bool5

---

Esempi per Riproduzione in corso

Blocco pulito del titolo su due righe

%title%%lb%{by %artist%}

Album e anno solo se l’anno esiste

%album%{ (%year%)}

Composer ● Artist solo quando esiste il compositore

{%composer% ● }%artist%

Riga in tre parti con \t (posizione / formato / durata)

%player.position%\t%format%\t%player.duration%

Mostrare Hi-Res solo con una frequenza di campionamento elevata

{%|format.samplerate>"48"% Hi-Res: %format.codec%}

Mostrare il dispositivo di uscita attivo (Android o altro renderer)

{ %output.current|renderer.type=="Android"%}{ %renderer.current|renderer.type!="Android"%}

Indicatore di qualità in stile Apple attivabile e disattivabile (usa bool1)

ⓘ {%format|bool1=="true"%}{Dolby Atmos %|format.channels>"2" && bool1=="false"%}{%string.high.efficiency|format.bitrate>"10" && format.bitrate<"256" && format.bitdepth==empty && bool1=="false"%}{%string.high.quality|format.bitrate>"255" && format.bitrate<"321" && format.bitdepth==empty && bool1=="false"%}{%string.lossless|format.bitdepth[]"16".."24" && format.samplerate<"49" && bool1=="false"%}{%string.hires.lossless|format.bitdepth[]"16".."32" && format.samplerate>"48" && bool1=="false"%}

Se associ un’azione toggle bool1 alla stringa personalizzata, questa alterna tra:

• la visualizzazione di %format% quando bool1 è true;
• la visualizzazione dell’indicatore in stile Apple quando bool1 è false.

Mostrare il volume corrente

Vol %volume.current%%

Titolo del capitolo corrente con indice

{%chapter.index% - }%chapter.title%

Tempo trascorso / rimanente del capitolo corrente

%chapter.position%\t%chapter.title%\t%chapter.remaining%

Avanzamento completo dell’audiolibro rispetto al primo capitolo

%chapter.all.position%\t%chapter.all.duration%

Titolo del capitolo successivo

%next.chapter.title%

Valori grezzi del formato

%format.codec% • %format.bitdepth%/%format.samplerate.raw% • %format.bitrate.raw%

---

Sottotitolo dell’album (pagina Album)

Le pagine degli album espongono normalmente metadati a livello di album, non lo stato della coda o del player. Puoi usare la stessa sintassi comune dei modelli.

Campi supportati (sottotitolo dell’album)

• title
• title.raw
• version
• tags
• type
• status
• composer
• artist
• year
• duration
• duration.seconds (secondi totali)
• duration.d (aggiungi .nz per nascondere il valore se è zero)
• duration.h (aggiungi .nz per nascondere il valore se è zero)
• duration.m (aggiungi .nz per nascondere il valore se è zero)
• duration.s (aggiungi .nz per nascondere il valore se è zero)
• duration.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• genre
• style
• mood
• language
• providername
• offlinestatus
• occasion
• mediatype
• grouping
• explicit
• releasedate
• originaldate
• releasedate.year
• originaldate.year
• lastplayed
• lastSkipped
• userrating
• rating
• userrating.5
• rating.5
• favorite
• song.count
• playcount
• skipcount
• description
• format
• format.bitrate
• format.channels
• format.samplerate
• format.bitdepth
• format.codec
• format.bitandsample
• format.bitrate.raw
• format.samplerate.raw
• lb

Esempi di sottotitolo dell’album

Titolo dell’album e versione solo se la versione esiste

%title%{ — %version%}

Riga con anno e genere che omette le parti mancanti

%year%{ • %genre%}

Valutazione mostrata solo se l’utente ha assegnato un voto

{★ %userrating.5%/5%|userrating!=empty%}

Indicatore Downloaded

{⬇ Offline%|offlinestatus!=empty%}

---

Sottotitolo dell’artista (pagina Artista)

Le pagine degli artisti espongono normalmente metadati a livello di artista e statistiche della libreria. Puoi usare la stessa sintassi comune dei modelli.

Campi supportati (sottotitolo dell’artista)

• title
• title.raw
• version
• tags
• type
• gender
• duration
• duration.seconds (secondi totali)
• duration.d (aggiungi .nz per nascondere il valore se è zero)
• duration.h (aggiungi .nz per nascondere il valore se è zero)
• duration.m (aggiungi .nz per nascondere il valore se è zero)
• duration.s (aggiungi .nz per nascondere il valore se è zero)
• duration.dd (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.hh (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.mm (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• duration.ss (completato con zeri; aggiungi .nz per nasconderlo se è zero)
• genre
• style
• mood
• song.count
• album.count
• instrument
• providername
• offlinestatus
• lastplayed
• userrating
• userrating.5
• favorite
• playcount
• description
• lb

Esempi di sottotitolo dell’artista

Mostrare i conteggi con le etichette

%song.count% songs{ • %album.count% albums}

Riga genere / stile

%genre%{ • %style%}

Mostrare il badge Favorite solo per i preferiti

{♥ Favorite%|favorite!=empty%}

Strumento su una nuova riga

%title%{\n%instrument%}

Pagine correlate

Interfaccia - Schermate Riproduzione in corsoConfigura le impostazioni Interfaccia - Schermate Riproduzione in corso di Symfonium, incluse le opzioni disponibili e il relativo comportamento in questa parte dell’app.

Riproduzione in corso - Player espansoConfigura le impostazioni Riproduzione in corso - Player espanso di Symfonium, incluse le opzioni disponibili e il relativo comportamento in questa parte dell’app.

Torna alla Wiki