1# SOME DESCRIPTIVE TITLE. 2# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. 3# 4#, fuzzy 5msgid "" 6msgstr "" 7"Project-Id-Version: PACKAGE VERSION\n" 8"Report-Msgid-Bugs-To: https://bugs.kde.org\n" 9"POT-Creation-Date: 2021-03-14 17:41+0000\n" 10"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 11"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" 12"Language-Team: LANGUAGE <kde-i18n-doc@kde.org>\n" 13"MIME-Version: 1.0\n" 14"Content-Type: text/plain; charset=UTF-8\n" 15"Content-Transfer-Encoding: 8bit\n" 16 17#. Tag: title 18#: index.docbook:11 19#, no-c-format 20msgid "The &kid3; Handbook" 21msgstr "" 22 23#. Tag: author 24#: index.docbook:14 25#, no-c-format 26msgid "<firstname>Urs</firstname> <surname>Fleisch</surname>" 27msgstr "" 28 29#. Tag: email 30#: index.docbook:18 31#, no-c-format 32msgid "ufleisch@users.sourceforge.net" 33msgstr "" 34 35#. Tag: contrib 36#: index.docbook:20 37#, no-c-format 38msgid "Software development" 39msgstr "" 40 41#. Tag: trans_comment 42#: index.docbook:23 43#, no-c-format 44msgid "ROLES_OF_TRANSLATORS" 45msgstr "" 46 47#. Tag: holder 48#: index.docbook:28 49#, no-c-format 50msgid "Urs Fleisch" 51msgstr "" 52 53#. Tag: date 54#: index.docbook:32 55#, no-c-format 56msgid "2021-03-18" 57msgstr "" 58 59#. Tag: releaseinfo 60#: index.docbook:33 61#, no-c-format 62msgid "3.8.6" 63msgstr "" 64 65#. Tag: para 66#: index.docbook:36 67#, no-c-format 68msgid "" 69"&kid3; is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an " 70"efficient way. Also tags in Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, " 71"MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF files and tracker modules " 72"(MOD, S3M, IT, XM) are supported. It is easy to set tags of multiple files " 73"to the same values (<abbrev>e.g.</abbrev> album, artist, year and genre in " 74"all files of the same album) and generate the tags from the file name or " 75"vice versa." 76msgstr "" 77 78#. Tag: keyword 79#: index.docbook:47 80#, no-c-format 81msgid "<keyword>KDE</keyword>" 82msgstr "" 83 84#. Tag: keyword 85#: index.docbook:48 86#, no-c-format 87msgid "kdemultimedia" 88msgstr "" 89 90#. Tag: keyword 91#: index.docbook:49 92#, no-c-format 93msgid "<keyword>MP3</keyword>" 94msgstr "" 95 96#. Tag: keyword 97#: index.docbook:50 98#, no-c-format 99msgid "<keyword>ID3</keyword>" 100msgstr "" 101 102#. Tag: keyword 103#: index.docbook:51 104#, no-c-format 105msgid "ID3v1" 106msgstr "" 107 108#. Tag: keyword 109#: index.docbook:52 110#, no-c-format 111msgid "ID3v2" 112msgstr "" 113 114#. Tag: keyword 115#: index.docbook:53 116#, no-c-format 117msgid "<keyword>Ogg</keyword>" 118msgstr "" 119 120#. Tag: keyword 121#: index.docbook:54 122#, no-c-format 123msgid "<keyword>Vorbis</keyword>" 124msgstr "" 125 126#. Tag: keyword 127#: index.docbook:55 128#, no-c-format 129msgid "FLAC" 130msgstr "" 131 132#. Tag: keyword 133#: index.docbook:56 134#, no-c-format 135msgid "<keyword>MPC</keyword>" 136msgstr "" 137 138#. Tag: keyword 139#: index.docbook:57 140#, no-c-format 141msgid "<keyword>APE</keyword>" 142msgstr "" 143 144#. Tag: keyword 145#: index.docbook:58 146#, no-c-format 147msgid "Musepack" 148msgstr "" 149 150#. Tag: keyword 151#: index.docbook:59 152#, no-c-format 153msgid "<keyword>MP4</keyword>" 154msgstr "" 155 156#. Tag: keyword 157#: index.docbook:60 158#, no-c-format 159msgid "<keyword>M4A</keyword>" 160msgstr "" 161 162#. Tag: keyword 163#: index.docbook:61 164#, no-c-format 165msgid "<keyword>MP2</keyword>" 166msgstr "" 167 168#. Tag: keyword 169#: index.docbook:62 170#, no-c-format 171msgid "Speex" 172msgstr "" 173 174#. Tag: keyword 175#: index.docbook:63 176#, no-c-format 177msgid "TrueAudio" 178msgstr "" 179 180#. Tag: keyword 181#: index.docbook:64 182#, no-c-format 183msgid "WavPack" 184msgstr "" 185 186#. Tag: keyword 187#: index.docbook:65 188#, no-c-format 189msgid "<keyword>WMA</keyword>" 190msgstr "" 191 192#. Tag: keyword 193#: index.docbook:66 194#, no-c-format 195msgid "<keyword>WAV</keyword>" 196msgstr "" 197 198#. Tag: keyword 199#: index.docbook:67 200#, no-c-format 201msgid "AIFF" 202msgstr "" 203 204#. Tag: keyword 205#: index.docbook:68 206#, no-c-format 207msgid "<keyword>MOD</keyword>" 208msgstr "" 209 210#. Tag: keyword 211#: index.docbook:69 212#, no-c-format 213msgid "<keyword>S3M</keyword>" 214msgstr "" 215 216#. Tag: keyword 217#: index.docbook:70 218#, no-c-format 219msgid "<keyword>IT</keyword>" 220msgstr "" 221 222#. Tag: keyword 223#: index.docbook:71 224#, no-c-format 225msgid "<keyword>XM</keyword>" 226msgstr "" 227 228#. Tag: keyword 229#: index.docbook:72 230#, no-c-format 231msgid "Opus" 232msgstr "" 233 234#. Tag: keyword 235#: index.docbook:73 236#, no-c-format 237msgid "<keyword>DSF</keyword>" 238msgstr "" 239 240#. Tag: title 241#: index.docbook:92 242#, no-c-format 243msgid "Synopsis" 244msgstr "" 245 246#. Tag: cmdsynopsis 247#: index.docbook:93 248#, no-c-format 249msgid "" 250"<command>kid3</command> <group> <arg choice=\"plain\"><option>&doublehyphen;" 251"help</option></arg> <arg choice=\"plain\"><option>&doublehyphen;author</" 252"option></arg> <arg choice=\"plain\"><option>&doublehyphen;version</option></" 253"arg> <arg choice=\"plain\"><option>&doublehyphen;license</option></arg> <arg " 254"choice=\"plain\"><option>&doublehyphen;desktopfile <filename>FILE</" 255"filename></option></arg> </group> <arg rep=\"repeat\"><replaceable>FILE</" 256"replaceable></arg>" 257msgstr "" 258 259#. Tag: cmdsynopsis 260#: index.docbook:105 261#, no-c-format 262msgid "" 263"<command>kid3-qt</command> <arg><option>&doublehyphen;portable</option></" 264"arg> <arg><option>Qt-options</option></arg> <arg rep=\"repeat" 265"\"><replaceable>FILE</replaceable></arg>" 266msgstr "" 267 268#. Tag: cmdsynopsis 269#: index.docbook:111 270#, no-c-format 271msgid "" 272"<command>kid3-cli</command> <arg><option>&doublehyphen;portable</option></" 273"arg> <arg><option>&doublehyphen;dbus</option></arg> <group> <arg choice=" 274"\"plain\"><option>-h</option></arg> <arg choice=\"plain" 275"\"><option>&doublehyphen;help</option></arg> </group> <arg><option>-c " 276"COMMAND1</option></arg> <arg rep=\"repeat\"><option>-c COMMAND2</option></" 277"arg> <arg rep=\"repeat\"><replaceable>FILE</replaceable></arg>" 278msgstr "" 279 280#. Tag: title 281#: index.docbook:125 282#, no-c-format 283msgid "Options" 284msgstr "" 285 286#. Tag: option 287#: index.docbook:129 288#, no-c-format 289msgid "&doublehyphen;portable" 290msgstr "" 291 292#. Tag: para 293#: index.docbook:130 294#, no-c-format 295msgid "" 296"Store configuration in file <filename>kid3.ini</filename> inside application " 297"folder." 298msgstr "" 299 300#. Tag: replaceable 301#: index.docbook:134 302#, no-c-format 303msgid "FILE" 304msgstr "" 305 306#. Tag: para 307#: index.docbook:135 308#, no-c-format 309msgid "" 310"If <filename><replaceable>FILE</replaceable></filename> is the path to a " 311"folder, it will be opened. If one or more file paths are given, their common " 312"folder is opened and the files are selected." 313msgstr "" 314 315#. Tag: title 316#: index.docbook:142 317#, no-c-format 318msgid "kid3" 319msgstr "" 320 321#. Tag: option 322#: index.docbook:145 323#, no-c-format 324msgid "&doublehyphen;help" 325msgstr "" 326 327#. Tag: para 328#: index.docbook:146 329#, no-c-format 330msgid "Show help about options." 331msgstr "" 332 333#. Tag: option 334#: index.docbook:149 335#, no-c-format 336msgid "&doublehyphen;author" 337msgstr "" 338 339#. Tag: para 340#: index.docbook:150 341#, no-c-format 342msgid "Show author information." 343msgstr "" 344 345#. Tag: option 346#: index.docbook:153 347#, no-c-format 348msgid "&doublehyphen;version" 349msgstr "" 350 351#. Tag: para 352#: index.docbook:154 353#, no-c-format 354msgid "Show version information." 355msgstr "" 356 357#. Tag: option 358#: index.docbook:157 359#, no-c-format 360msgid "&doublehyphen;license" 361msgstr "" 362 363#. Tag: para 364#: index.docbook:158 365#, no-c-format 366msgid "Show license information." 367msgstr "" 368 369#. Tag: option 370#: index.docbook:161 371#, no-c-format 372msgid "&doublehyphen;desktopfile <filename>FILE</filename>" 373msgstr "" 374 375#. Tag: para 376#: index.docbook:163 377#, no-c-format 378msgid "The base file name of the desktop entry for this application." 379msgstr "" 380 381#. Tag: title 382#: index.docbook:169 383#, no-c-format 384msgid "kid3-qt" 385msgstr "" 386 387#. Tag: option 388#: index.docbook:172 389#, no-c-format 390msgid "Qt-options" 391msgstr "" 392 393#. Tag: para 394#: index.docbook:173 395#, no-c-format 396msgid "" 397"See <citerefentry><refentrytitle>qt5options</refentrytitle> <manvolnum>7</" 398"manvolnum></citerefentry>." 399msgstr "" 400 401#. Tag: title 402#: index.docbook:179 index.docbook:2622 403#, no-c-format 404msgid "kid3-cli" 405msgstr "" 406 407#. Tag: option 408#: index.docbook:183 409#, no-c-format 410msgid "&doublehyphen;dbus" 411msgstr "" 412 413#. Tag: para 414#: index.docbook:184 415#, no-c-format 416msgid "Activate the &DBus; interface." 417msgstr "" 418 419#. Tag: option 420#: index.docbook:188 421#, no-c-format 422msgid "<option>-c</option>" 423msgstr "" 424 425#. Tag: para 426#: index.docbook:189 427#, no-c-format 428msgid "" 429"Execute a command. Multiple <option>-c</option> options are possible, they " 430"are executed in sequence. See the section about <link linkend=\"kid3-cli" 431"\">kid3-cli</link> for a description of the available commands." 432msgstr "" 433 434#. Tag: term 435#: index.docbook:196 436#, no-c-format 437msgid "<option>-h</option>|<option>&doublehyphen;help</option>" 438msgstr "" 439 440#. Tag: para 441#: index.docbook:197 442#, no-c-format 443msgid "Show help about options and commands." 444msgstr "" 445 446#. Tag: title 447#: index.docbook:206 448#, no-c-format 449msgid "Introduction" 450msgstr "" 451 452#. Tag: para 453#: index.docbook:208 454#, no-c-format 455msgid "" 456"&kid3; is an application to edit the ID3v1 and ID3v2 tags in MP3 files in an " 457"efficient way. These tags can be edited by most MP3 players, but not in a " 458"very comfortable and efficient way. Moreover the tags in Ogg/Vorbis, Opus, " 459"DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF " 460"files and tracker modules (MOD, S3M, IT, XM) are supported too." 461msgstr "" 462 463#. Tag: para 464#: index.docbook:215 465#, no-c-format 466msgid "" 467"&kid3; does not grab nor encode MP3 files, but it is targeted to edit the " 468"ID3 tags of all files of an album in an efficient way, <abbrev>i.e.</abbrev> " 469"with as few mouse clicks and key strokes as possible. Where most other " 470"programs can edit either ID3v1 or ID3v2 tags, &kid3; has full control over " 471"both versions, can convert tags between the two formats and has access to " 472"all ID3v2 tags. Tags of multiple files can be set to the same value, " 473"<abbrev>e.g.</abbrev> the artist, album, year and genre of all files of an " 474"album typically have the same values and can be set together. If the " 475"information for the tags is contained in the file name, the tags can be " 476"automatically set from the file name. It is also possible to set the file " 477"name according to the tags found in the file in arbitrary formats." 478msgstr "" 479 480#. Tag: para 481#: index.docbook:228 482#, no-c-format 483msgid "" 484"The editing task is further supported by automatic replacement of characters " 485"or substrings, for instance to remove illegal characters from filenames. " 486"Automatic control of upper and lower case characters makes it easy to use a " 487"consistent naming scheme in all tags." 488msgstr "" 489 490#. Tag: para 491#: index.docbook:234 492#, no-c-format 493msgid "" 494"The tag information for full albums can be taken from <ulink url=\"http://" 495"gnudb.org\">gnudb.org</ulink>, <ulink url=\"http://musicbrainz.org" 496"\">MusicBrainz</ulink>, <ulink url=\"http://discogs.com\">Discogs</ulink>, " 497"<ulink url=\"http://www.amazon.com\">Amazon</ulink> or other sources of " 498"track lists. The import format is freely configurable by regular expressions." 499msgstr "" 500 501#. Tag: para 502#: index.docbook:242 503#, no-c-format 504msgid "Please report any problems or feature requests to the author." 505msgstr "" 506 507#. Tag: title 508#: index.docbook:248 509#, no-c-format 510msgid "Using &kid3;" 511msgstr "" 512 513#. Tag: title 514#: index.docbook:251 515#, no-c-format 516msgid "&kid3; features" 517msgstr "" 518 519#. Tag: para 520#: index.docbook:253 521#, no-c-format 522msgid "Edit ID3v1.1 tags" 523msgstr "" 524 525#. Tag: para 526#: index.docbook:254 527#, no-c-format 528msgid "Edit all ID3v2.3 and ID3v2.4 frames" 529msgstr "" 530 531#. Tag: para 532#: index.docbook:255 533#, no-c-format 534msgid "Edit tags of multiple files" 535msgstr "" 536 537#. Tag: para 538#: index.docbook:256 539#, no-c-format 540msgid "Convert between ID3v1 and ID3v2 tags" 541msgstr "" 542 543#. Tag: para 544#: index.docbook:257 545#, no-c-format 546msgid "" 547"Edit MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, " 548"TrueAudio, WavPack, WMA, WAV and AIFF tags" 549msgstr "" 550 551#. Tag: para 552#: index.docbook:259 553#, no-c-format 554msgid "Generate tags from filename" 555msgstr "" 556 557#. Tag: para 558#: index.docbook:260 559#, no-c-format 560msgid "Generate tags from the contents of tag fields" 561msgstr "" 562 563#. Tag: para 564#: index.docbook:261 565#, no-c-format 566msgid "Generate filename from tags" 567msgstr "" 568 569#. Tag: para 570#: index.docbook:262 571#, no-c-format 572msgid "Generate and change folder names from tags" 573msgstr "" 574 575#. Tag: para 576#: index.docbook:263 577#, no-c-format 578msgid "Generate playlist file" 579msgstr "" 580 581#. Tag: para 582#: index.docbook:264 583#, no-c-format 584msgid "Automatic case conversion and string translation" 585msgstr "" 586 587#. Tag: para 588#: index.docbook:265 589#, no-c-format 590msgid "" 591"Import from <ulink url=\"http://gnudb.org\">gnudb.org</ulink>, <ulink url=" 592"\"http://musicbrainz.org\">MusicBrainz</ulink>, <ulink url=\"http://discogs." 593"com\">Discogs</ulink>, <ulink url=\"http://www.amazon.com\">Amazon</ulink> " 594"and other data sources" 595msgstr "" 596 597#. Tag: para 598#: index.docbook:270 599#, no-c-format 600msgid "" 601"Export as CSV, &HTML;, playlist, Kover &XML; and other formats. Exported CSV " 602"files can be imported again." 603msgstr "" 604 605#. Tag: title 606#: index.docbook:276 607#, no-c-format 608msgid "Example Usage" 609msgstr "" 610 611#. Tag: para 612#: index.docbook:277 613#, no-c-format 614msgid "" 615"This section describes a typical session with &kid3;. Let's assume we have a " 616"folder containing MP3 files with the tracks from the album \"Let's Tag\" " 617"from the band \"One Hit Wonder\". The folder is named in the \"artist - album" 618"\" format, in our case <filename>One Hit Wonder - Let's Tag</filename>. The " 619"folder contains the tracks in the \"track title.mp3\" format, which I think " 620"is useful because the filenames are short (important when using mobile MP3 " 621"players with small displays) and in the correct order when sorted " 622"alphabetically (important when using hardware MP3 players which play the " 623"tracks in alphabetical order or in the order in which they are burnt on &CD; " 624"and that order is alphabetical when using <command>mkisofs</command>). " 625"Besides this, the artist and album information is already in the folder name " 626"and does not have to be repeated in the filename. But back to our example, " 627"the folder listing looks like this:" 628msgstr "" 629 630#. Tag: filename 631#: index.docbook:292 632#, no-c-format 633msgid "01 Intro.mp3" 634msgstr "" 635 636#. Tag: filename 637#: index.docbook:293 638#, no-c-format 639msgid "02 We Only Got This One.mp3" 640msgstr "" 641 642#. Tag: filename 643#: index.docbook:294 644#, no-c-format 645msgid "03 Outro.mp3" 646msgstr "" 647 648#. Tag: para 649#: index.docbook:295 650#, no-c-format 651msgid "" 652"These files have no tags yet and we want to generate them using &kid3;. We " 653"use <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></" 654"menuchoice> menu item (or toolbar button) and select one of the files in " 655"this folder. All files will be displayed in the file listbox. Lazy as we " 656"are, we want to use the information in the folder and file names to generate " 657"tags. Therefore we select all files, then click the <guilabel>To:</guilabel> " 658"<guibutton>Tag 1</guibutton> button in the <guilabel>File</guilabel> " 659"section. This will set the title, artist, album and track values in all " 660"files. To set the year and genre values of all files, we keep all files " 661"selected and type in \"2002\" for the <guilabel>Date</guilabel> and select " 662"\"Pop\" from the <guilabel>Genre</guilabel> combobox. To set only these two " 663"values, their check boxes are automatically checked and all other check " 664"boxes are left unchecked. Now we change the selection by only selecting the " 665"first file and we see that all tags contain the correct values. The tags of " 666"the other files can be verified too by selecting them one by one. When we " 667"are satisfied with the tags, we use <menuchoice><guimenu>File</" 668"guimenu><guimenuitem>Save</guimenuitem></menuchoice> menu item (or toolbar " 669"button). Selecting <menuchoice><guimenu>File</guimenu><guimenuitem> Create " 670"Playlist</guimenuitem></menuchoice> menu item (or toolbar button) will " 671"generate a file <filename>One Hit Wonder - Let's Tag.m3u</filename> in the " 672"folder." 673msgstr "" 674 675#. Tag: title 676#: index.docbook:320 677#, no-c-format 678msgid "Command Reference" 679msgstr "" 680 681#. Tag: title 682#: index.docbook:323 683#, no-c-format 684msgid "The &GUI; Elements" 685msgstr "" 686 687#. Tag: para 688#: index.docbook:324 689#, no-c-format 690msgid "" 691"The &kid3; &GUI; is separated in six sections: At the left are the file and " 692"folder listboxes, the right side contains the <guilabel>File</guilabel>, " 693"<guilabel>Tag 1</guilabel>, <guilabel>Tag 2</guilabel> and <guilabel>Tag 3 </" 694"guilabel> sections." 695msgstr "" 696 697#. Tag: para 698#: index.docbook:331 699#, no-c-format 700msgid "" 701"To navigate between the different sections using the keyboard, several " 702"keyboard shortcuts are supported. In the tag sections, the shortcuts are " 703"active while not editing text or when being in the first column." 704msgstr "" 705 706#. Tag: para 707#: index.docbook:337 708#, no-c-format 709msgid "" 710"<keycombo>&Alt;<keycap>Left</keycap></keycombo>: Go to previous section " 711"(<keycombo><keycap>Command</keycap><keycap>[</keycap></keycombo> on &macOS;)" 712msgstr "" 713 714#. Tag: para 715#: index.docbook:341 716#, no-c-format 717msgid "" 718"<keycombo>&Alt;<keycap>Right</keycap></keycombo>: Go to next section " 719"(<keycombo><keycap>Command</keycap><keycap>]</keycap></keycombo> on &macOS;)" 720msgstr "" 721 722#. Tag: para 723#: index.docbook:345 724#, no-c-format 725msgid "" 726"<keycombo>&Ctrl;<keycap>Shift</keycap><keycap>V</keycap></keycombo>: From " 727"other tag" 728msgstr "" 729 730#. Tag: para 731#: index.docbook:349 732#, no-c-format 733msgid "<keycombo>&Ctrl;<keycap>C</keycap></keycombo>: Copy" 734msgstr "" 735 736#. Tag: para 737#: index.docbook:352 738#, no-c-format 739msgid "<keycombo>&Ctrl;<keycap>V</keycap></keycombo>: Paste" 740msgstr "" 741 742#. Tag: para 743#: index.docbook:355 744#, no-c-format 745msgid "" 746"<keycombo><keycap>Shift</keycap><keycap>Delete</keycap></keycombo>: Remove" 747msgstr "" 748 749#. Tag: para 750#: index.docbook:358 751#, no-c-format 752msgid "<keycombo><keycap>F2</keycap></keycombo>: Edit" 753msgstr "" 754 755#. Tag: para 756#: index.docbook:361 757#, no-c-format 758msgid "<keycombo><keycap>Insert</keycap></keycombo>: Add" 759msgstr "" 760 761#. Tag: para 762#: index.docbook:364 763#, no-c-format 764msgid "<keycombo><keycap>Delete</keycap></keycombo>: Delete" 765msgstr "" 766 767#. Tag: title 768#: index.docbook:371 769#, no-c-format 770msgid "File List" 771msgstr "" 772 773#. Tag: para 774#: index.docbook:373 775#, no-c-format 776msgid "" 777"The file list contains the names of all the files in the opened folder which " 778"match the selected file name filter (typically <filename class=\"extension" 779"\">*.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac *.m4a *.m4b *.m4p *.mp4 *.mp2 " 780"*.spx *.tta *.wv *.wma *.wav *.aiff *.ape</filename>). A single or multiple " 781"files can be selected. To select no file, click into the empty area after " 782"the listbox entries. The selection determines the files which are affected " 783"by the operations which are available by using the buttons described below." 784msgstr "" 785 786#. Tag: para 787#: index.docbook:383 788#, no-c-format 789msgid "" 790"Besides <guilabel>Name</guilabel>, also other columns <guilabel>Size</" 791"guilabel>, <guilabel>Type</guilabel>, <guilabel>Date Modified</guilabel> " 792"with file details can be displayed. Columns can be hidden by unchecking " 793"their name in the context menu of the list header. The order of the columns " 794"can be changed by drag and drop. The sort order can be toggled by clicking " 795"on the column header." 796msgstr "" 797 798#. Tag: para 799#: index.docbook:391 800#, no-c-format 801msgid "" 802"At the left of the names an icon can be displayed: a disc to show that the " 803"file has been modified or information about which tags are present (V1, V2, " 804"V1V2 or NO TAG, no icon is displayed if the file has not been read in yet)." 805msgstr "" 806 807#. Tag: para 808#: index.docbook:396 809#, no-c-format 810msgid "" 811"Folders are displayed with a folder icon. If a folder is opened, its files " 812"are displayed in a hierarchical tree. By selecting files from subfolders, " 813"operations can be executed on files in different folders, which is useful if " 814"the music collection is organized with a folder for each artist containing " 815"folders for albums of this artist." 816msgstr "" 817 818#. Tag: para 819#: index.docbook:403 820#, no-c-format 821msgid "" 822"Clicking the <mousebutton>right</mousebutton> mouse button inside the file " 823"list opens a context menu with the following commands:" 824msgstr "" 825 826#. Tag: para 827#: index.docbook:407 828#, no-c-format 829msgid "" 830"<guimenuitem>Expand all</guimenuitem>: Expands all folder trees (only the " 831"current tree if the <keycap>Shift</keycap> key is pressed)" 832msgstr "" 833 834#. Tag: para 835#: index.docbook:411 836#, no-c-format 837msgid "<guimenuitem>Collapse all</guimenuitem>: Collapses all folder trees" 838msgstr "" 839 840#. Tag: para 841#: index.docbook:414 842#, no-c-format 843msgid "<guimenuitem>Rename</guimenuitem>: Changes the name of a file" 844msgstr "" 845 846#. Tag: para 847#: index.docbook:417 848#, no-c-format 849msgid "<guimenuitem>Move to Trash</guimenuitem>: Moves a file to the trash" 850msgstr "" 851 852#. Tag: para 853#: index.docbook:420 854#, no-c-format 855msgid "" 856"<guimenuitem>Play</guimenuitem>: Plays a file, see <link linkend=\"play" 857"\">Play</link>. If the selected file is a playlist, the files of the " 858"playlist will be played." 859msgstr "" 860 861#. Tag: para 862#: index.docbook:425 863#, no-c-format 864msgid "" 865"<guimenuitem>Edit</guimenuitem>: Edit a playlist, see <link linkend=\"edit-" 866"playlist\">Edit Playlist</link>." 867msgstr "" 868 869#. Tag: para 870#: index.docbook:429 871#, no-c-format 872msgid "" 873"The subsequent entries are user commands, which can be defined in the " 874"<guilabel>User Actions</guilabel> tab of <link linkend=\"configure-" 875"kid3\">Configure &kid3;</link>. The playback on double click can also be " 876"activated there." 877msgstr "" 878 879#. Tag: title 880#: index.docbook:439 881#, no-c-format 882msgid "Edit Playlist" 883msgstr "" 884 885#. Tag: para 886#: index.docbook:441 887#, no-c-format 888msgid "" 889"A playlist can be created empty or containing the tracks of a folder, see " 890"<link linkend=\"create-playlist\">Create Playlist</link>. The playlist file " 891"created in such a way can be edited by double click or using <guilabel>Edit</" 892"guilabel> from the file list context menu. A dialog with the entries of the " 893"playlist is shown. It is possible to open multiple playlists simultaneously." 894msgstr "" 895 896#. Tag: para 897#: index.docbook:448 898#, no-c-format 899msgid "" 900"New entries can be added by drag and drop from the file list, a file manager " 901"or another playlist. If an entry is dragged from another playlist, it will " 902"be moved or copied depending on the system. To invoke the other operation, " 903"respectively, the <keycap>Shift</keycap>, &Ctrl; or &Alt; (to copy instead " 904"of move on &macOS;) key has to be pressed. Reordering entries within the " 905"playlist is also possible via drag and drop. Alternatively, entries can be " 906"moved using the keyboard shortcuts <keycombo>&Ctrl;<keycap>Shift</" 907"keycap><keycap>Up</keycap></keycombo> and <keycombo>&Ctrl;<keycap>Shift</" 908"keycap><keycap>Down</keycap></keycombo> (on &macOS; <keycap>Command</keycap> " 909"has to be pressed instead of &Ctrl;). An entry can be removed using the " 910"<keycap>Delete</keycap> key." 911msgstr "" 912 913#. Tag: para 914#: index.docbook:459 915#, no-c-format 916msgid "" 917"Please note the following: To drag entries from the file list, they have to " 918"be held at the left side (near the icons), the same gesture at the right " 919"side will perform a multi selection, such an action is hereby still easily " 920"possible." 921msgstr "" 922 923#. Tag: para 924#: index.docbook:464 925#, no-c-format 926msgid "" 927"When a playlist has been modified, the changes can be stored using " 928"<guibutton>Save</guibutton> or discarded using <guibutton>Cancel</" 929"guibutton>. When the window is closed, a confirmation prompt is shown if " 930"there are unsaved changes." 931msgstr "" 932 933#. Tag: para 934#: index.docbook:470 935#, no-c-format 936msgid "" 937"Tracks selected in a playlist will be automatically selected in the file " 938"list, thereby making it possible to edit their tags." 939msgstr "" 940 941#. Tag: para 942#: index.docbook:474 943#, no-c-format 944msgid "" 945"To execute actions on a playlist, its file must be selected in the file " 946"list. <guimenuitem>Edit</guimenuitem> from the context menu will lead to the " 947"dialog described in this section, and <guimenuitem>Play</guimenuitem> will " 948"start the media player with the tracks from the playlist. User actions can " 949"act on playlists, for <link linkend=\"qml-examples\">example</link> " 950"<guilabel>Export Playlist Folder</guilabel>, which copies the files from a " 951"playlist into a folder." 952msgstr "" 953 954#. Tag: title 955#: index.docbook:486 956#, no-c-format 957msgid "Folder List" 958msgstr "" 959 960#. Tag: para 961#: index.docbook:488 962#, no-c-format 963msgid "" 964"The folder list contains the names of the folders in the opened folder, as " 965"well as the current (<filename class=\"directory\">.</filename>) and the " 966"parent (<filename class=\"directory\">..</filename>) folder. It allows one " 967"to quickly change the folder without using the <guimenuitem>Open</" 968"guimenuitem> command or drag and drop." 969msgstr "" 970 971#. Tag: para 972#: index.docbook:495 973#, no-c-format 974msgid "" 975"Column visibility, order and sorting can be configured as described in the " 976"section about the <link linkend=\"file-list\">file list</link>." 977msgstr "" 978 979#. Tag: title 980#: index.docbook:502 981#, no-c-format 982msgid "File" 983msgstr "" 984 985#. Tag: para 986#: index.docbook:504 987#, no-c-format 988msgid "" 989"Shows information about the encoding (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, " 990"MP2, MP4, AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), bit rate, sample " 991"rate, channels and the length of the file." 992msgstr "" 993 994#. Tag: para 995#: index.docbook:509 996#, no-c-format 997msgid "" 998"The <guilabel>Name</guilabel> line edit contains the name of the file (if " 999"only a single file is selected). If this name is changed, the file will be " 1000"renamed when the Save command is used." 1001msgstr "" 1002 1003#. Tag: para 1004#: index.docbook:514 1005#, no-c-format 1006msgid "" 1007"The <guilabel>Format</guilabel> combo box and line edit contains the format " 1008"to be used when the filename is generated from the first or the second tag. " 1009"The filename can contain arbitrary characters, even a folder part separated " 1010"by a slash from the file name, but that folder must already exist for the " 1011"renaming to succeed. The following special codes are used to insert tag " 1012"values into the filename:" 1013msgstr "" 1014 1015#. Tag: para 1016#: index.docbook:524 index.docbook:1216 index.docbook:1515 index.docbook:1815 1017#: index.docbook:1895 index.docbook:2450 1018#, no-c-format 1019msgid "%s %{title} Title (Song)" 1020msgstr "" 1021 1022#. Tag: para 1023#: index.docbook:525 index.docbook:1217 index.docbook:1516 index.docbook:1816 1024#: index.docbook:1896 index.docbook:2451 1025#, no-c-format 1026msgid "%a %{artist} Artist" 1027msgstr "" 1028 1029#. Tag: para 1030#: index.docbook:526 index.docbook:1218 index.docbook:1517 index.docbook:1817 1031#: index.docbook:1897 index.docbook:2452 1032#, no-c-format 1033msgid "%l %{album} Album" 1034msgstr "" 1035 1036#. Tag: para 1037#: index.docbook:527 index.docbook:1219 index.docbook:1518 index.docbook:1818 1038#: index.docbook:1898 index.docbook:2453 1039#, no-c-format 1040msgid "%c %{comment} Comment" 1041msgstr "" 1042 1043#. Tag: para 1044#: index.docbook:528 index.docbook:1220 index.docbook:1519 index.docbook:1819 1045#: index.docbook:1899 index.docbook:2454 1046#, no-c-format 1047msgid "%y %{year} Year" 1048msgstr "" 1049 1050#. Tag: para 1051#: index.docbook:529 index.docbook:1520 index.docbook:1820 index.docbook:1900 1052#: index.docbook:2455 1053#, no-c-format 1054msgid "%t %{track} Track (<abbrev>e.g.</abbrev> 01)" 1055msgstr "" 1056 1057#. Tag: para 1058#: index.docbook:530 index.docbook:1521 index.docbook:1821 index.docbook:1901 1059#: index.docbook:2456 1060#, no-c-format 1061msgid "" 1062"%t %{track.n} Track with field width n (<abbrev>e.g.</abbrev> 001 for " 1063"%{track.3})" 1064msgstr "" 1065 1066#. Tag: para 1067#: index.docbook:531 index.docbook:1522 index.docbook:1822 index.docbook:1902 1068#: index.docbook:2457 1069#, no-c-format 1070msgid "" 1071"%T %{tracknumber} Track (without leading zeros, <abbrev>e.g.</abbrev> 1)" 1072msgstr "" 1073 1074#. Tag: para 1075#: index.docbook:532 index.docbook:1222 index.docbook:1523 index.docbook:1823 1076#: index.docbook:1903 index.docbook:2458 1077#, no-c-format 1078msgid "%g %{genre} Genre" 1079msgstr "" 1080 1081#. Tag: para 1082#: index.docbook:533 1083#, no-c-format 1084msgid "%{ignore} Ignored when generating tags from the file name" 1085msgstr "" 1086 1087#. Tag: para 1088#: index.docbook:536 1089#, no-c-format 1090msgid "" 1091"The format codes are not restricted to the examples given above. Any frame " 1092"name can be used, for instance unified frame names like <userinput>" 1093"%{albumartist}</userinput>, <userinput>%{discnumber.1}</userinput>, " 1094"<userinput>%{bpm}</userinput> or format specific names like <userinput>" 1095"%{popm}</userinput>." 1096msgstr "" 1097 1098#. Tag: para 1099#: index.docbook:544 1100#, no-c-format 1101msgid "" 1102"It is possible to prepend and append strings to the replacement for a format " 1103"code by adding them in double quotes inside the curly braces of a format " 1104"code. These strings will only be put into the resulting string if the format " 1105"code yields a nonempty value. For example, if the file name shall both " 1106"contain the title and the subtitle, one could use <userinput>%{title} " 1107"[%{subtitle}]</userinput> in the format string. But this would result in a " 1108"string ending with <computeroutput> []</computeroutput> if no subtitle frame " 1109"exists for a file. In order to omit the brackets if no subtitle is present, " 1110"<userinput>%{title}%{\" [\"subtitle\"]\"}</userinput> shall be used instead. " 1111"This will omit the brackets, the leading space and the subtitle if not " 1112"subtitle exists." 1113msgstr "" 1114 1115#. Tag: para 1116#: index.docbook:558 1117#, no-c-format 1118msgid "" 1119"The list of available formats can be edited in the dialog which appears when " 1120"clicking the <guibutton>Filename from tag</guibutton> button in the " 1121"<guilabel>File</guilabel> tab of the <link linkend=\"configure-" 1122"kid3\">settings</link>." 1123msgstr "" 1124 1125#. Tag: para 1126#: index.docbook:565 1127#, no-c-format 1128msgid "" 1129"A second <guilabel>Format</guilabel> combo box (with arrow down) is used to " 1130"generate the tags from the filename. If the format of the filename does not " 1131"match this pattern, a few other commonly used formats are tried." 1132msgstr "" 1133 1134#. Tag: para 1135#: index.docbook:572 1136#, no-c-format 1137msgid "" 1138"Some commonly used filename formats are already available in the combo box, " 1139"but it is also possible to type in some special format into the line edit." 1140msgstr "" 1141 1142#. Tag: para 1143#: index.docbook:577 1144#, no-c-format 1145msgid "" 1146"The list of available formats can be edited in the dialog which appears when " 1147"clicking the <guibutton>Tag from filename</guibutton> button in the " 1148"<guilabel>File</guilabel> tab of the <link linkend=\"configure-" 1149"kid3\">settings</link>." 1150msgstr "" 1151 1152#. Tag: para 1153#: index.docbook:584 1154#, no-c-format 1155msgid "" 1156"Internally, a regular expression is built from the format codes. If advanced " 1157"regular expressions are required, the format to generate the tags from the " 1158"filenames can be given as a complete regular expression with captures which " 1159"are preceded by the format codes, <abbrev>e.g.</abbrev> to extract the track " 1160"numbers without removal of leading zeros, a format like \"<userinput>/" 1161"%{track}(\\d+) %{title}(.*)</userinput>\" could be used." 1162msgstr "" 1163 1164#. Tag: para 1165#: index.docbook:592 1166#, no-c-format 1167msgid "" 1168"<guilabel>From:</guilabel> <guibutton>Tag 1</guibutton>, <guibutton>Tag 2</" 1169"guibutton>: Sets the filename using the selected format and the first tag or " 1170"the second tag, respectively." 1171msgstr "" 1172 1173#. Tag: para 1174#: index.docbook:597 1175#, no-c-format 1176msgid "" 1177"<guilabel>To:</guilabel> <guibutton>Tag 1</guibutton>, <guibutton>Tag 2</" 1178"guibutton>: The tags are set from the filename. First, the format specified " 1179"in <guilabel>Format</guilabel> is used. If the existing filename does not " 1180"match this format, the following formats are tried:" 1181msgstr "" 1182 1183#. Tag: filename 1184#: index.docbook:605 1185#, no-c-format 1186msgid "Artist - Album/Track Song" 1187msgstr "" 1188 1189#. Tag: filename 1190#: index.docbook:606 1191#, no-c-format 1192msgid "Album/Track - Artist - Song" 1193msgstr "" 1194 1195#. Tag: filename 1196#: index.docbook:607 1197#, no-c-format 1198msgid "/Artist - Album - Track - Song" 1199msgstr "" 1200 1201#. Tag: filename 1202#: index.docbook:608 1203#, no-c-format 1204msgid "Album/Artist - Track - Song" 1205msgstr "" 1206 1207#. Tag: filename 1208#: index.docbook:609 1209#, no-c-format 1210msgid "Album/Artist - Song" 1211msgstr "" 1212 1213#. Tag: filename 1214#: index.docbook:610 1215#, no-c-format 1216msgid "Artist/Album/Track Song" 1217msgstr "" 1218 1219#. Tag: para 1220#: index.docbook:612 1221#, no-c-format 1222msgid "" 1223"If a single file is selected, the &GUI; controls are filled with the values " 1224"extracted from the filename. If multiple files are selected, the tags of the " 1225"files are directly set according to the filenames." 1226msgstr "" 1227 1228#. Tag: title 1229#: index.docbook:620 1230#, no-c-format 1231msgid "Tag 1" 1232msgstr "" 1233 1234#. Tag: para 1235#: index.docbook:622 1236#, no-c-format 1237msgid "" 1238"The line edit widgets for <guilabel>Title</guilabel>, <guilabel>Artist</" 1239"guilabel>, <guilabel>Album</guilabel>, <guilabel>Comment</guilabel>, " 1240"<guilabel>Date</guilabel>, <guilabel>Track Number</guilabel> and " 1241"<guilabel>Genre</guilabel> are used to edit the corresponding value in the " 1242"first tag of the selected files. The value will be changed when the file " 1243"selection is altered or before operations like <guimenuitem>Save</" 1244"guimenuitem> and <guimenuitem>Quit</guimenuitem> and when the corresponding " 1245"check box at the left of the field name is checked. This is useful to change " 1246"only some values and leave the other values unchanged." 1247msgstr "" 1248 1249#. Tag: para 1250#: index.docbook:634 1251#, no-c-format 1252msgid "" 1253"If a single file is selected, all check boxes are checked and the line edit " 1254"widgets contain the values found in the tags of this file. If a tag is not " 1255"found in the file, the corresponding empty value is displayed, which is an " 1256"empty string for the <guilabel>Title</guilabel>, <guilabel>Artist</" 1257"guilabel>, <guilabel>Album</guilabel> and <guilabel>Comment</guilabel> line " 1258"edits, 0 for the numerical <guilabel>Date</guilabel> and <guilabel>Track " 1259"Number</guilabel> edits and an empty selected value for the <guilabel>Genre</" 1260"guilabel> combo box. The values can be changed and if the corresponding " 1261"check box is checked, they will be set for the selected file after the " 1262"selection is changed. The file is then marked as modified by a disk symbol " 1263"in the file listbox but remains unchanged until the <guimenuitem>Save</" 1264"guimenuitem> command is used." 1265msgstr "" 1266 1267#. Tag: para 1268#: index.docbook:648 1269#, no-c-format 1270msgid "" 1271"If multiple files are selected, only the values which are identical in all " 1272"selected files are displayed. In all other controls, the empty values as " 1273"described above are displayed. All check boxes are unchecked to avoid " 1274"unwanted changes. If a value has to be set for all selected files, it can be " 1275"edited and the check box has to be set. The values will be set for all " 1276"selected files when the selection is changed and can be saved using the " 1277"<guimenuitem>Save</guimenuitem> command." 1278msgstr "" 1279 1280#. Tag: para 1281#: index.docbook:657 1282#, no-c-format 1283msgid "" 1284"The check boxes also control the operation of most commands affecting the " 1285"tags, such as copy, paste and transfer between tags 1 and 2. To make it " 1286"easier to use with multiple files where all check boxes are unchecked, these " 1287"commands behave in the same way when all check boxes are checked and when " 1288"all check boxes are unchecked." 1289msgstr "" 1290 1291#. Tag: para 1292#: index.docbook:664 1293#, no-c-format 1294msgid "" 1295"<guibutton>From Tag 2</guibutton>: The tag 1 fields are set from the " 1296"corresponding values in tag 2. If a single file is selected, the &GUI; " 1297"controls are filled with the values from tag 2. If multiple files are " 1298"selected, the tags of the files are directly set." 1299msgstr "" 1300 1301#. Tag: para 1302#: index.docbook:671 1303#, no-c-format 1304msgid "" 1305"<guibutton>Copy</guibutton>: The copy buffer is filled with the Tag 1 " 1306"values. Only values with checked check box will be used in subsequent Paste " 1307"commands." 1308msgstr "" 1309 1310#. Tag: para 1311#: index.docbook:675 1312#, no-c-format 1313msgid "" 1314"<guibutton>Paste</guibutton>: Pastes the values from the copy buffer into " 1315"the &GUI; controls." 1316msgstr "" 1317 1318#. Tag: para 1319#: index.docbook:679 1320#, no-c-format 1321msgid "" 1322"<guibutton>Remove</guibutton>: This will set all &GUI; controls to their " 1323"empty values which results in removing all values. The saved file will then " 1324"contain no tag 1." 1325msgstr "" 1326 1327#. Tag: title 1328#: index.docbook:687 1329#, no-c-format 1330msgid "Tag 2" 1331msgstr "" 1332 1333#. Tag: para 1334#: index.docbook:689 1335#, no-c-format 1336msgid "" 1337"The &GUI; controls function in the same way as described for the " 1338"<guilabel>Tag 1</guilabel> section, but the size of the strings is not " 1339"limited." 1340msgstr "" 1341 1342#. Tag: para 1343#: index.docbook:693 1344#, no-c-format 1345msgid "" 1346"For the tag 2 <guilabel>Genre</guilabel> you can also use your own names " 1347"besides the genres listed in the combo box, just type the name into the line " 1348"edit." 1349msgstr "" 1350 1351#. Tag: para 1352#: index.docbook:698 1353#, no-c-format 1354msgid "" 1355"The tag 2 cannot only contain the same values as the tag 1, the format is " 1356"built in a flexible way from several frames which are themselves composed of " 1357"several fields. The tag 2 table shows all the frames which are available in " 1358"the selected file." 1359msgstr "" 1360 1361#. Tag: para 1362#: index.docbook:704 1363#, no-c-format 1364msgid "" 1365"<guibutton>Edit</guibutton>: This will open a window which allows one to " 1366"edit all fields of the selected frame. If multiple files are selected, the " 1367"edited fields are applied to all selected files which contain such a frame." 1368msgstr "" 1369 1370#. Tag: para 1371#: index.docbook:710 1372#, no-c-format 1373msgid "" 1374"<guibutton>Add</guibutton>: A requester to select the frame type will appear " 1375"and a frame of the selected type can be edited and added to the file. This " 1376"works also to add a frame to multiple selected files." 1377msgstr "" 1378 1379#. Tag: para 1380#: index.docbook:715 1381#, no-c-format 1382msgid "" 1383"<guibutton>Delete</guibutton>: Deletes the selected frame in the selected " 1384"files." 1385msgstr "" 1386 1387#. Tag: para 1388#: index.docbook:718 1389#, no-c-format 1390msgid "" 1391"<guilabel>Drag album artwork here</guilabel> is shown if the file does not " 1392"contain embedded cover art. A picture can be added using drag and drop from " 1393"a browser or file manager and will be displayed here. Picture frames can be " 1394"edited or added by double clicking on this control." 1395msgstr "" 1396 1397#. Tag: title 1398#: index.docbook:728 1399#, no-c-format 1400msgid "Tag 3" 1401msgstr "" 1402 1403#. Tag: para 1404#: index.docbook:730 1405#, no-c-format 1406msgid "" 1407"Some files can have more than two tags, and a third tag section is visible. " 1408"The following file types can have such a <guilabel>Tag 3</guilabel> section:" 1409msgstr "" 1410 1411#. Tag: para 1412#: index.docbook:735 1413#, no-c-format 1414msgid "" 1415"MP3 files can have an ID3v1.1 tag, an ID3v2 (2.3.0 or 2.4.0) tag and in the " 1416"third section an APE tag. Such APE tags are used for replay gain " 1417"information. In the <guilabel>Tag 3</guilabel> section, this information is " 1418"visible, and the APE tag can be removed with the <guibutton>Remove</" 1419"guibutton> button." 1420msgstr "" 1421 1422#. Tag: para 1423#: index.docbook:742 1424#, no-c-format 1425msgid "" 1426"The RIFF INFO chunk of WAV files is available in the <guilabel>Tag 3 </" 1427"guilabel> section because the <guilabel>Tag 1</guilabel> section is " 1428"dedicated to ID3v1.1 tags and handles their restrictions. The <guilabel>Tag " 1429"2</guilabel> is still used for ID3v2.4.0 tags, which are also supported for " 1430"WAV files, but RIFF INFO chunks seem to be supported better." 1431msgstr "" 1432 1433#. Tag: para 1434#: index.docbook:749 1435#, no-c-format 1436msgid "" 1437"FLAC files normally use a Vorbis comment for their meta data. However, there " 1438"are FLAC files which have ID3v1 and ID3v2 tags, which can be found in the " 1439"<guilabel>Tag 1</guilabel> and <guilabel>Tag 3</guilabel> sections. ID3 tags " 1440"in FLAC files are only supported by TagLib, therefore the OggFlacMetadata " 1441"plugin has to be disabled in the <guilabel>Plugins</guilabel> tab of the " 1442"<link linkend=\"configure-kid3\">settings</link>." 1443msgstr "" 1444 1445#. Tag: para 1446#: index.docbook:758 1447#, no-c-format 1448msgid "" 1449"The &GUI; controls work in the same way as in the <guilabel>Tag 2</guilabel> " 1450"section." 1451msgstr "" 1452 1453#. Tag: title 1454#: index.docbook:767 1455#, no-c-format 1456msgid "Frame List" 1457msgstr "" 1458 1459#. Tag: para 1460#: index.docbook:769 1461#, no-c-format 1462msgid "" 1463"&kid3; can edit most of the frames for all of the supported file types. Some " 1464"frames are accessed using unified names, so that they can be exchanged " 1465"between files with different formats. Frames which are not unified can be " 1466"accessed as format specific frames." 1467msgstr "" 1468 1469#. Tag: title 1470#: index.docbook:777 1471#, no-c-format 1472msgid "Mapping of Unified Frame Types to Various Formats" 1473msgstr "" 1474 1475#. Tag: entry 1476#: index.docbook:780 1477#, no-c-format 1478msgid "Unified" 1479msgstr "" 1480 1481#. Tag: entry 1482#: index.docbook:780 1483#, no-c-format 1484msgid "ID3v2.3" 1485msgstr "" 1486 1487#. Tag: entry 1488#: index.docbook:780 1489#, no-c-format 1490msgid "ID3v2.4" 1491msgstr "" 1492 1493#. Tag: entry 1494#: index.docbook:780 1495#, no-c-format 1496msgid "<entry>MP4</entry>" 1497msgstr "" 1498 1499#. Tag: entry 1500#: index.docbook:780 1501#, no-c-format 1502msgid "<entry>ASF</entry>" 1503msgstr "" 1504 1505#. Tag: entry 1506#: index.docbook:780 1507#, no-c-format 1508msgid "<entry>Vorbis</entry>" 1509msgstr "" 1510 1511#. Tag: entry 1512#: index.docbook:780 1513#, no-c-format 1514msgid "RIFF" 1515msgstr "" 1516 1517#. Tag: entry 1518#: index.docbook:783 1519#, no-c-format 1520msgid "<entry>Title</entry>" 1521msgstr "" 1522 1523#. Tag: literal 1524#: index.docbook:783 1525#, no-c-format 1526msgid "TIT2" 1527msgstr "" 1528 1529#. Tag: literal 1530#: index.docbook:783 1531#, no-c-format 1532msgid "©nam" 1533msgstr "" 1534 1535#. Tag: literal 1536#: index.docbook:783 1537#, no-c-format 1538msgid "<literal>Title</literal>" 1539msgstr "" 1540 1541#. Tag: literal 1542#: index.docbook:783 1543#, no-c-format 1544msgid "TITLE" 1545msgstr "" 1546 1547#. Tag: literal 1548#: index.docbook:783 1549#, no-c-format 1550msgid "INAM" 1551msgstr "" 1552 1553#. Tag: entry 1554#: index.docbook:784 1555#, no-c-format 1556msgid "Artist" 1557msgstr "" 1558 1559#. Tag: literal 1560#: index.docbook:784 1561#, no-c-format 1562msgid "TPE1" 1563msgstr "" 1564 1565#. Tag: literal 1566#: index.docbook:784 1567#, no-c-format 1568msgid "©ART" 1569msgstr "" 1570 1571#. Tag: literal 1572#: index.docbook:784 1573#, no-c-format 1574msgid "<literal>Author</literal>" 1575msgstr "" 1576 1577#. Tag: literal 1578#: index.docbook:784 1579#, no-c-format 1580msgid "ARTIST" 1581msgstr "" 1582 1583#. Tag: literal 1584#: index.docbook:784 1585#, no-c-format 1586msgid "IART" 1587msgstr "" 1588 1589#. Tag: entry 1590#: index.docbook:785 1591#, no-c-format 1592msgid "Album" 1593msgstr "" 1594 1595#. Tag: literal 1596#: index.docbook:785 1597#, no-c-format 1598msgid "TALB" 1599msgstr "" 1600 1601#. Tag: literal 1602#: index.docbook:785 1603#, no-c-format 1604msgid "©alb" 1605msgstr "" 1606 1607#. Tag: literal 1608#: index.docbook:785 1609#, no-c-format 1610msgid "WM/AlbumTitle" 1611msgstr "" 1612 1613#. Tag: literal 1614#: index.docbook:785 1615#, no-c-format 1616msgid "ALBUM" 1617msgstr "" 1618 1619#. Tag: literal 1620#: index.docbook:785 1621#, no-c-format 1622msgid "IPRD" 1623msgstr "" 1624 1625#. Tag: entry 1626#: index.docbook:786 1627#, no-c-format 1628msgid "Comment" 1629msgstr "" 1630 1631#. Tag: literal 1632#: index.docbook:786 1633#, no-c-format 1634msgid "COMM" 1635msgstr "" 1636 1637#. Tag: literal 1638#: index.docbook:786 1639#, no-c-format 1640msgid "©cmt" 1641msgstr "" 1642 1643#. Tag: literal 1644#: index.docbook:786 1645#, no-c-format 1646msgid "<literal>Description</literal>" 1647msgstr "" 1648 1649#. Tag: literal 1650#: index.docbook:786 1651#, no-c-format 1652msgid "COMMENT" 1653msgstr "" 1654 1655#. Tag: literal 1656#: index.docbook:786 1657#, no-c-format 1658msgid "ICMT" 1659msgstr "" 1660 1661#. Tag: entry 1662#: index.docbook:787 1663#, no-c-format 1664msgid "Date" 1665msgstr "" 1666 1667#. Tag: literal 1668#: index.docbook:787 1669#, no-c-format 1670msgid "TYER" 1671msgstr "" 1672 1673#. Tag: literal 1674#: index.docbook:787 1675#, no-c-format 1676msgid "TDRC" 1677msgstr "" 1678 1679#. Tag: literal 1680#: index.docbook:787 1681#, no-c-format 1682msgid "©day" 1683msgstr "" 1684 1685#. Tag: literal 1686#: index.docbook:787 1687#, no-c-format 1688msgid "WM/Year" 1689msgstr "" 1690 1691#. Tag: literal 1692#: index.docbook:787 1693#, no-c-format 1694msgid "DATE" 1695msgstr "" 1696 1697#. Tag: literal 1698#: index.docbook:787 1699#, no-c-format 1700msgid "ICRD" 1701msgstr "" 1702 1703#. Tag: entry 1704#: index.docbook:788 1705#, no-c-format 1706msgid "Track Number" 1707msgstr "" 1708 1709#. Tag: literal 1710#: index.docbook:788 1711#, no-c-format 1712msgid "TRCK" 1713msgstr "" 1714 1715#. Tag: literal 1716#: index.docbook:788 1717#, no-c-format 1718msgid "trkn" 1719msgstr "" 1720 1721#. Tag: literal 1722#: index.docbook:788 1723#, no-c-format 1724msgid "WM/TrackNumber" 1725msgstr "" 1726 1727#. Tag: literal 1728#: index.docbook:788 1729#, no-c-format 1730msgid "TRACKNUMBER" 1731msgstr "" 1732 1733#. Tag: entry 1734#: index.docbook:788 1735#, no-c-format 1736msgid "<literal>IPRT</literal> or <literal>ITRK</literal>" 1737msgstr "" 1738 1739#. Tag: entry 1740#: index.docbook:789 1741#, no-c-format 1742msgid "Genre" 1743msgstr "" 1744 1745#. Tag: literal 1746#: index.docbook:789 1747#, no-c-format 1748msgid "TCON" 1749msgstr "" 1750 1751#. Tag: literal 1752#: index.docbook:789 1753#, no-c-format 1754msgid "©gen" 1755msgstr "" 1756 1757#. Tag: literal 1758#: index.docbook:789 1759#, no-c-format 1760msgid "WM/Genre" 1761msgstr "" 1762 1763#. Tag: literal 1764#: index.docbook:789 1765#, no-c-format 1766msgid "GENRE" 1767msgstr "" 1768 1769#. Tag: literal 1770#: index.docbook:789 1771#, no-c-format 1772msgid "IGNR" 1773msgstr "" 1774 1775#. Tag: entry 1776#: index.docbook:790 1777#, no-c-format 1778msgid "Album Artist" 1779msgstr "" 1780 1781#. Tag: literal 1782#: index.docbook:790 1783#, no-c-format 1784msgid "TPE2" 1785msgstr "" 1786 1787#. Tag: literal 1788#: index.docbook:790 1789#, no-c-format 1790msgid "aART" 1791msgstr "" 1792 1793#. Tag: literal 1794#: index.docbook:790 1795#, no-c-format 1796msgid "WM/AlbumArtist" 1797msgstr "" 1798 1799#. Tag: literal 1800#: index.docbook:790 1801#, no-c-format 1802msgid "ALBUMARTIST" 1803msgstr "" 1804 1805#. Tag: entry 1806#: index.docbook:791 1807#, no-c-format 1808msgid "Arranger" 1809msgstr "" 1810 1811#. Tag: literal 1812#: index.docbook:791 index.docbook:815 1813#, no-c-format 1814msgid "IPLS" 1815msgstr "" 1816 1817#. Tag: literal 1818#: index.docbook:791 1819#, no-c-format 1820msgid "TIPL" 1821msgstr "" 1822 1823#. Tag: literal 1824#: index.docbook:791 1825#, no-c-format 1826msgid "ARRANGER" 1827msgstr "" 1828 1829#. Tag: literal 1830#: index.docbook:791 1831#, no-c-format 1832msgid "WM/Producer" 1833msgstr "" 1834 1835#. Tag: literal 1836#: index.docbook:791 1837#, no-c-format 1838msgid "IENG" 1839msgstr "" 1840 1841#. Tag: entry 1842#: index.docbook:792 1843#, no-c-format 1844msgid "<entry>Author</entry>" 1845msgstr "" 1846 1847#. Tag: literal 1848#: index.docbook:792 1849#, no-c-format 1850msgid "TOLY" 1851msgstr "" 1852 1853#. Tag: literal 1854#: index.docbook:792 1855#, no-c-format 1856msgid "AUTHOR" 1857msgstr "" 1858 1859#. Tag: entry 1860#: index.docbook:793 1861#, no-c-format 1862msgid "<entry>BPM</entry>" 1863msgstr "" 1864 1865#. Tag: literal 1866#: index.docbook:793 1867#, no-c-format 1868msgid "TBPM" 1869msgstr "" 1870 1871#. Tag: literal 1872#: index.docbook:793 1873#, no-c-format 1874msgid "tmpo" 1875msgstr "" 1876 1877#. Tag: literal 1878#: index.docbook:793 1879#, no-c-format 1880msgid "WM/BeatsPerMinute" 1881msgstr "" 1882 1883#. Tag: literal 1884#: index.docbook:793 1885#, no-c-format 1886msgid "<literal>BPM</literal>" 1887msgstr "" 1888 1889#. Tag: literal 1890#: index.docbook:793 1891#, no-c-format 1892msgid "IBPM" 1893msgstr "" 1894 1895#. Tag: entry 1896#: index.docbook:794 1897#, no-c-format 1898msgid "Catalog Number" 1899msgstr "" 1900 1901#. Tag: literal 1902#: index.docbook:794 1903#, no-c-format 1904msgid "TXXX:CATALOGNUMBER" 1905msgstr "" 1906 1907#. Tag: literal 1908#: index.docbook:794 1909#, no-c-format 1910msgid "CATALOGNUMBER" 1911msgstr "" 1912 1913#. Tag: entry 1914#: index.docbook:795 1915#, no-c-format 1916msgid "Compilation" 1917msgstr "" 1918 1919#. Tag: literal 1920#: index.docbook:795 1921#, no-c-format 1922msgid "TCMP" 1923msgstr "" 1924 1925#. Tag: literal 1926#: index.docbook:795 1927#, no-c-format 1928msgid "cpil" 1929msgstr "" 1930 1931#. Tag: literal 1932#: index.docbook:795 1933#, no-c-format 1934msgid "COMPILATION" 1935msgstr "" 1936 1937#. Tag: entry 1938#: index.docbook:796 1939#, no-c-format 1940msgid "Composer" 1941msgstr "" 1942 1943#. Tag: literal 1944#: index.docbook:796 1945#, no-c-format 1946msgid "TCOM" 1947msgstr "" 1948 1949#. Tag: literal 1950#: index.docbook:796 1951#, no-c-format 1952msgid "©wrt" 1953msgstr "" 1954 1955#. Tag: literal 1956#: index.docbook:796 1957#, no-c-format 1958msgid "WM/Composer" 1959msgstr "" 1960 1961#. Tag: literal 1962#: index.docbook:796 1963#, no-c-format 1964msgid "COMPOSER" 1965msgstr "" 1966 1967#. Tag: literal 1968#: index.docbook:796 1969#, no-c-format 1970msgid "IMUS" 1971msgstr "" 1972 1973#. Tag: entry 1974#: index.docbook:797 1975#, no-c-format 1976msgid "Conductor" 1977msgstr "" 1978 1979#. Tag: literal 1980#: index.docbook:797 1981#, no-c-format 1982msgid "TPE3" 1983msgstr "" 1984 1985#. Tag: literal 1986#: index.docbook:797 1987#, no-c-format 1988msgid "CONDUCTOR" 1989msgstr "" 1990 1991#. Tag: literal 1992#: index.docbook:797 1993#, no-c-format 1994msgid "WM/Conductor" 1995msgstr "" 1996 1997#. Tag: entry 1998#: index.docbook:798 1999#, no-c-format 2000msgid "<entry>Copyright</entry>" 2001msgstr "" 2002 2003#. Tag: literal 2004#: index.docbook:798 2005#, no-c-format 2006msgid "TCOP" 2007msgstr "" 2008 2009#. Tag: literal 2010#: index.docbook:798 2011#, no-c-format 2012msgid "cprt" 2013msgstr "" 2014 2015#. Tag: literal 2016#: index.docbook:798 2017#, no-c-format 2018msgid "<literal>Copyright</literal>" 2019msgstr "" 2020 2021#. Tag: literal 2022#: index.docbook:798 2023#, no-c-format 2024msgid "COPYRIGHT" 2025msgstr "" 2026 2027#. Tag: literal 2028#: index.docbook:798 2029#, no-c-format 2030msgid "ICOP" 2031msgstr "" 2032 2033#. Tag: entry 2034#: index.docbook:799 2035#, no-c-format 2036msgid "<entry>Description</entry>" 2037msgstr "" 2038 2039#. Tag: literal 2040#: index.docbook:799 2041#, no-c-format 2042msgid "TIT3" 2043msgstr "" 2044 2045#. Tag: literal 2046#: index.docbook:799 2047#, no-c-format 2048msgid "desc" 2049msgstr "" 2050 2051#. Tag: literal 2052#: index.docbook:799 2053#, no-c-format 2054msgid "WM/SubTitleDescription" 2055msgstr "" 2056 2057#. Tag: literal 2058#: index.docbook:799 2059#, no-c-format 2060msgid "DESCRIPTION" 2061msgstr "" 2062 2063#. Tag: entry 2064#: index.docbook:800 2065#, no-c-format 2066msgid "Disc Number" 2067msgstr "" 2068 2069#. Tag: literal 2070#: index.docbook:800 2071#, no-c-format 2072msgid "TPOS" 2073msgstr "" 2074 2075#. Tag: literal 2076#: index.docbook:800 2077#, no-c-format 2078msgid "disk" 2079msgstr "" 2080 2081#. Tag: literal 2082#: index.docbook:800 2083#, no-c-format 2084msgid "WM/PartOfSet" 2085msgstr "" 2086 2087#. Tag: literal 2088#: index.docbook:800 2089#, no-c-format 2090msgid "DISCNUMBER" 2091msgstr "" 2092 2093#. Tag: entry 2094#: index.docbook:801 2095#, no-c-format 2096msgid "Encoded-by" 2097msgstr "" 2098 2099#. Tag: literal 2100#: index.docbook:801 2101#, no-c-format 2102msgid "TENC" 2103msgstr "" 2104 2105#. Tag: literal 2106#: index.docbook:801 2107#, no-c-format 2108msgid "©enc" 2109msgstr "" 2110 2111#. Tag: literal 2112#: index.docbook:801 2113#, no-c-format 2114msgid "WM/EncodedBy" 2115msgstr "" 2116 2117#. Tag: literal 2118#: index.docbook:801 2119#, no-c-format 2120msgid "ENCODED-BY" 2121msgstr "" 2122 2123#. Tag: literal 2124#: index.docbook:801 2125#, no-c-format 2126msgid "ITCH" 2127msgstr "" 2128 2129#. Tag: entry 2130#: index.docbook:802 2131#, no-c-format 2132msgid "Encoder Settings" 2133msgstr "" 2134 2135#. Tag: literal 2136#: index.docbook:802 2137#, no-c-format 2138msgid "TSSE" 2139msgstr "" 2140 2141#. Tag: literal 2142#: index.docbook:802 2143#, no-c-format 2144msgid "©too" 2145msgstr "" 2146 2147#. Tag: literal 2148#: index.docbook:802 2149#, no-c-format 2150msgid "WM/EncodingSettings" 2151msgstr "" 2152 2153#. Tag: literal 2154#: index.docbook:802 2155#, no-c-format 2156msgid "ENCODERSETTINGS" 2157msgstr "" 2158 2159#. Tag: literal 2160#: index.docbook:802 2161#, no-c-format 2162msgid "ISFT" 2163msgstr "" 2164 2165#. Tag: entry 2166#: index.docbook:803 2167#, no-c-format 2168msgid "Encoding Time" 2169msgstr "" 2170 2171#. Tag: literal 2172#: index.docbook:803 2173#, no-c-format 2174msgid "TDEN" 2175msgstr "" 2176 2177#. Tag: literal 2178#: index.docbook:803 2179#, no-c-format 2180msgid "WM/EncodingTime" 2181msgstr "" 2182 2183#. Tag: literal 2184#: index.docbook:803 2185#, no-c-format 2186msgid "ENCODINGTIME" 2187msgstr "" 2188 2189#. Tag: literal 2190#: index.docbook:803 2191#, no-c-format 2192msgid "IDIT" 2193msgstr "" 2194 2195#. Tag: entry 2196#: index.docbook:804 2197#, no-c-format 2198msgid "Grouping" 2199msgstr "" 2200 2201#. Tag: literal 2202#: index.docbook:804 2203#, no-c-format 2204msgid "GRP1" 2205msgstr "" 2206 2207#. Tag: literal 2208#: index.docbook:804 2209#, no-c-format 2210msgid "©grp" 2211msgstr "" 2212 2213#. Tag: literal 2214#: index.docbook:804 2215#, no-c-format 2216msgid "GROUPING" 2217msgstr "" 2218 2219#. Tag: entry 2220#: index.docbook:805 2221#, no-c-format 2222msgid "Initial Key" 2223msgstr "" 2224 2225#. Tag: literal 2226#: index.docbook:805 2227#, no-c-format 2228msgid "TKEY" 2229msgstr "" 2230 2231#. Tag: literal 2232#: index.docbook:805 2233#, no-c-format 2234msgid "WM/InitialKey" 2235msgstr "" 2236 2237#. Tag: literal 2238#: index.docbook:805 2239#, no-c-format 2240msgid "INITIALKEY" 2241msgstr "" 2242 2243#. Tag: entry 2244#: index.docbook:806 2245#, no-c-format 2246msgid "<entry>ISRC</entry>" 2247msgstr "" 2248 2249#. Tag: literal 2250#: index.docbook:806 2251#, no-c-format 2252msgid "TSRC" 2253msgstr "" 2254 2255#. Tag: literal 2256#: index.docbook:806 2257#, no-c-format 2258msgid "<literal>ISRC</literal>" 2259msgstr "" 2260 2261#. Tag: literal 2262#: index.docbook:806 2263#, no-c-format 2264msgid "WM/ISRC" 2265msgstr "" 2266 2267#. Tag: entry 2268#: index.docbook:807 2269#, no-c-format 2270msgid "Language" 2271msgstr "" 2272 2273#. Tag: literal 2274#: index.docbook:807 2275#, no-c-format 2276msgid "TLAN" 2277msgstr "" 2278 2279#. Tag: literal 2280#: index.docbook:807 2281#, no-c-format 2282msgid "LANGUAGE" 2283msgstr "" 2284 2285#. Tag: literal 2286#: index.docbook:807 2287#, no-c-format 2288msgid "WM/Language" 2289msgstr "" 2290 2291#. Tag: literal 2292#: index.docbook:807 2293#, no-c-format 2294msgid "ILNG" 2295msgstr "" 2296 2297#. Tag: entry 2298#: index.docbook:808 2299#, no-c-format 2300msgid "Lyricist" 2301msgstr "" 2302 2303#. Tag: literal 2304#: index.docbook:808 2305#, no-c-format 2306msgid "TEXT" 2307msgstr "" 2308 2309#. Tag: literal 2310#: index.docbook:808 2311#, no-c-format 2312msgid "LYRICIST" 2313msgstr "" 2314 2315#. Tag: literal 2316#: index.docbook:808 2317#, no-c-format 2318msgid "WM/Writer" 2319msgstr "" 2320 2321#. Tag: literal 2322#: index.docbook:808 2323#, no-c-format 2324msgid "IWRI" 2325msgstr "" 2326 2327#. Tag: entry 2328#: index.docbook:809 2329#, no-c-format 2330msgid "Lyrics" 2331msgstr "" 2332 2333#. Tag: literal 2334#: index.docbook:809 2335#, no-c-format 2336msgid "USLT" 2337msgstr "" 2338 2339#. Tag: literal 2340#: index.docbook:809 2341#, no-c-format 2342msgid "©lyr" 2343msgstr "" 2344 2345#. Tag: literal 2346#: index.docbook:809 2347#, no-c-format 2348msgid "WM/Lyrics" 2349msgstr "" 2350 2351#. Tag: literal 2352#: index.docbook:809 2353#, no-c-format 2354msgid "LYRICS" 2355msgstr "" 2356 2357#. Tag: entry 2358#: index.docbook:810 2359#, no-c-format 2360msgid "Media" 2361msgstr "" 2362 2363#. Tag: literal 2364#: index.docbook:810 2365#, no-c-format 2366msgid "TMED" 2367msgstr "" 2368 2369#. Tag: literal 2370#: index.docbook:810 2371#, no-c-format 2372msgid "SOURCEMEDIA" 2373msgstr "" 2374 2375#. Tag: literal 2376#: index.docbook:810 2377#, no-c-format 2378msgid "IMED" 2379msgstr "" 2380 2381#. Tag: entry 2382#: index.docbook:811 2383#, no-c-format 2384msgid "Mood" 2385msgstr "" 2386 2387#. Tag: literal 2388#: index.docbook:811 2389#, no-c-format 2390msgid "TMOO" 2391msgstr "" 2392 2393#. Tag: literal 2394#: index.docbook:811 2395#, no-c-format 2396msgid "WM/Mood" 2397msgstr "" 2398 2399#. Tag: literal 2400#: index.docbook:811 2401#, no-c-format 2402msgid "MOOD" 2403msgstr "" 2404 2405#. Tag: entry 2406#: index.docbook:812 2407#, no-c-format 2408msgid "Original Album" 2409msgstr "" 2410 2411#. Tag: literal 2412#: index.docbook:812 2413#, no-c-format 2414msgid "TOAL" 2415msgstr "" 2416 2417#. Tag: literal 2418#: index.docbook:812 2419#, no-c-format 2420msgid "ORIGINALALBUM" 2421msgstr "" 2422 2423#. Tag: literal 2424#: index.docbook:812 2425#, no-c-format 2426msgid "WM/OriginalAlbumTitle" 2427msgstr "" 2428 2429#. Tag: entry 2430#: index.docbook:813 2431#, no-c-format 2432msgid "Original Artist" 2433msgstr "" 2434 2435#. Tag: literal 2436#: index.docbook:813 2437#, no-c-format 2438msgid "TOPE" 2439msgstr "" 2440 2441#. Tag: literal 2442#: index.docbook:813 2443#, no-c-format 2444msgid "ORIGINALARTIST" 2445msgstr "" 2446 2447#. Tag: literal 2448#: index.docbook:813 2449#, no-c-format 2450msgid "WM/OriginalArtist" 2451msgstr "" 2452 2453#. Tag: entry 2454#: index.docbook:814 2455#, no-c-format 2456msgid "Original Date" 2457msgstr "" 2458 2459#. Tag: literal 2460#: index.docbook:814 2461#, no-c-format 2462msgid "TORY" 2463msgstr "" 2464 2465#. Tag: literal 2466#: index.docbook:814 2467#, no-c-format 2468msgid "TDOR" 2469msgstr "" 2470 2471#. Tag: literal 2472#: index.docbook:814 2473#, no-c-format 2474msgid "ORIGINALDATE" 2475msgstr "" 2476 2477#. Tag: literal 2478#: index.docbook:814 2479#, no-c-format 2480msgid "WM/OriginalReleaseYear" 2481msgstr "" 2482 2483#. Tag: entry 2484#: index.docbook:815 2485#, no-c-format 2486msgid "Performer" 2487msgstr "" 2488 2489#. Tag: literal 2490#: index.docbook:815 2491#, no-c-format 2492msgid "TMCL" 2493msgstr "" 2494 2495#. Tag: literal 2496#: index.docbook:815 2497#, no-c-format 2498msgid "PERFORMER" 2499msgstr "" 2500 2501#. Tag: literal 2502#: index.docbook:815 2503#, no-c-format 2504msgid "ISTR" 2505msgstr "" 2506 2507#. Tag: entry 2508#: index.docbook:816 2509#, no-c-format 2510msgid "Picture" 2511msgstr "" 2512 2513#. Tag: literal 2514#: index.docbook:816 2515#, no-c-format 2516msgid "APIC" 2517msgstr "" 2518 2519#. Tag: literal 2520#: index.docbook:816 2521#, no-c-format 2522msgid "covr" 2523msgstr "" 2524 2525#. Tag: literal 2526#: index.docbook:816 2527#, no-c-format 2528msgid "WM/Picture" 2529msgstr "" 2530 2531#. Tag: literal 2532#: index.docbook:816 2533#, no-c-format 2534msgid "METADATA_BLOCK_PICTURE" 2535msgstr "" 2536 2537#. Tag: entry 2538#: index.docbook:817 2539#, no-c-format 2540msgid "Publisher" 2541msgstr "" 2542 2543#. Tag: literal 2544#: index.docbook:817 2545#, no-c-format 2546msgid "TPUB" 2547msgstr "" 2548 2549#. Tag: literal 2550#: index.docbook:817 2551#, no-c-format 2552msgid "PUBLISHER" 2553msgstr "" 2554 2555#. Tag: literal 2556#: index.docbook:817 2557#, no-c-format 2558msgid "WM/Publisher" 2559msgstr "" 2560 2561#. Tag: literal 2562#: index.docbook:817 2563#, no-c-format 2564msgid "IPUB" 2565msgstr "" 2566 2567#. Tag: entry 2568#: index.docbook:818 2569#, no-c-format 2570msgid "Rating" 2571msgstr "" 2572 2573#. Tag: literal 2574#: index.docbook:818 2575#, no-c-format 2576msgid "<literal>POPM</literal>" 2577msgstr "" 2578 2579#. Tag: literal 2580#: index.docbook:818 2581#, no-c-format 2582msgid "rate" 2583msgstr "" 2584 2585#. Tag: literal 2586#: index.docbook:818 2587#, no-c-format 2588msgid "WM/SharedUserRating" 2589msgstr "" 2590 2591#. Tag: literal 2592#: index.docbook:818 2593#, no-c-format 2594msgid "RATING" 2595msgstr "" 2596 2597#. Tag: literal 2598#: index.docbook:818 2599#, no-c-format 2600msgid "IRTD" 2601msgstr "" 2602 2603#. Tag: entry 2604#: index.docbook:819 2605#, no-c-format 2606msgid "Release Country" 2607msgstr "" 2608 2609#. Tag: literal 2610#: index.docbook:819 2611#, no-c-format 2612msgid "TXXX:RELEASECOUNTRY" 2613msgstr "" 2614 2615#. Tag: literal 2616#: index.docbook:819 2617#, no-c-format 2618msgid "RELEASECOUNTRY" 2619msgstr "" 2620 2621#. Tag: literal 2622#: index.docbook:819 2623#, no-c-format 2624msgid "ICNT" 2625msgstr "" 2626 2627#. Tag: entry 2628#: index.docbook:820 2629#, no-c-format 2630msgid "Release Date" 2631msgstr "" 2632 2633#. Tag: literal 2634#: index.docbook:820 2635#, no-c-format 2636msgid "TDRL" 2637msgstr "" 2638 2639#. Tag: literal 2640#: index.docbook:820 2641#, no-c-format 2642msgid "RELEASEDATE" 2643msgstr "" 2644 2645#. Tag: entry 2646#: index.docbook:821 2647#, no-c-format 2648msgid "Remixer" 2649msgstr "" 2650 2651#. Tag: literal 2652#: index.docbook:821 2653#, no-c-format 2654msgid "TPE4" 2655msgstr "" 2656 2657#. Tag: literal 2658#: index.docbook:821 2659#, no-c-format 2660msgid "REMIXER" 2661msgstr "" 2662 2663#. Tag: literal 2664#: index.docbook:821 2665#, no-c-format 2666msgid "WM/ModifiedBy" 2667msgstr "" 2668 2669#. Tag: literal 2670#: index.docbook:821 2671#, no-c-format 2672msgid "IEDT" 2673msgstr "" 2674 2675#. Tag: entry 2676#: index.docbook:822 2677#, no-c-format 2678msgid "Sort Album" 2679msgstr "" 2680 2681#. Tag: literal 2682#: index.docbook:822 2683#, no-c-format 2684msgid "TSOA" 2685msgstr "" 2686 2687#. Tag: literal 2688#: index.docbook:822 2689#, no-c-format 2690msgid "soal" 2691msgstr "" 2692 2693#. Tag: literal 2694#: index.docbook:822 2695#, no-c-format 2696msgid "WM/AlbumSortOrder" 2697msgstr "" 2698 2699#. Tag: literal 2700#: index.docbook:822 2701#, no-c-format 2702msgid "ALBUMSORT" 2703msgstr "" 2704 2705#. Tag: entry 2706#: index.docbook:823 2707#, no-c-format 2708msgid "Sort Album Artist" 2709msgstr "" 2710 2711#. Tag: literal 2712#: index.docbook:823 2713#, no-c-format 2714msgid "TSO2" 2715msgstr "" 2716 2717#. Tag: literal 2718#: index.docbook:823 2719#, no-c-format 2720msgid "soaa" 2721msgstr "" 2722 2723#. Tag: literal 2724#: index.docbook:823 2725#, no-c-format 2726msgid "ALBUMARTISTSORT" 2727msgstr "" 2728 2729#. Tag: entry 2730#: index.docbook:824 2731#, no-c-format 2732msgid "Sort Artist" 2733msgstr "" 2734 2735#. Tag: literal 2736#: index.docbook:824 2737#, no-c-format 2738msgid "TSOP" 2739msgstr "" 2740 2741#. Tag: literal 2742#: index.docbook:824 2743#, no-c-format 2744msgid "soar" 2745msgstr "" 2746 2747#. Tag: literal 2748#: index.docbook:824 2749#, no-c-format 2750msgid "WM/ArtistSortOrder" 2751msgstr "" 2752 2753#. Tag: literal 2754#: index.docbook:824 2755#, no-c-format 2756msgid "ARTISTSORT" 2757msgstr "" 2758 2759#. Tag: entry 2760#: index.docbook:825 2761#, no-c-format 2762msgid "Sort Composer" 2763msgstr "" 2764 2765#. Tag: literal 2766#: index.docbook:825 2767#, no-c-format 2768msgid "TSOC" 2769msgstr "" 2770 2771#. Tag: literal 2772#: index.docbook:825 2773#, no-c-format 2774msgid "soco" 2775msgstr "" 2776 2777#. Tag: literal 2778#: index.docbook:825 2779#, no-c-format 2780msgid "COMPOSERSORT" 2781msgstr "" 2782 2783#. Tag: entry 2784#: index.docbook:826 2785#, no-c-format 2786msgid "Sort Name" 2787msgstr "" 2788 2789#. Tag: literal 2790#: index.docbook:826 2791#, no-c-format 2792msgid "TSOT" 2793msgstr "" 2794 2795#. Tag: literal 2796#: index.docbook:826 2797#, no-c-format 2798msgid "sonm" 2799msgstr "" 2800 2801#. Tag: literal 2802#: index.docbook:826 2803#, no-c-format 2804msgid "WM/TitleSortOrder" 2805msgstr "" 2806 2807#. Tag: literal 2808#: index.docbook:826 2809#, no-c-format 2810msgid "TITLESORT" 2811msgstr "" 2812 2813#. Tag: entry 2814#: index.docbook:827 2815#, no-c-format 2816msgid "Subtitle" 2817msgstr "" 2818 2819#. Tag: literal 2820#: index.docbook:827 2821#, no-c-format 2822msgid "TSST" 2823msgstr "" 2824 2825#. Tag: literal 2826#: index.docbook:827 2827#, no-c-format 2828msgid "SUBTITLE" 2829msgstr "" 2830 2831#. Tag: literal 2832#: index.docbook:827 2833#, no-c-format 2834msgid "WM/SubTitle" 2835msgstr "" 2836 2837#. Tag: literal 2838#: index.docbook:827 2839#, no-c-format 2840msgid "PRT1" 2841msgstr "" 2842 2843#. Tag: entry 2844#: index.docbook:828 2845#, no-c-format 2846msgid "Website" 2847msgstr "" 2848 2849#. Tag: literal 2850#: index.docbook:828 2851#, no-c-format 2852msgid "WOAR" 2853msgstr "" 2854 2855#. Tag: literal 2856#: index.docbook:828 2857#, no-c-format 2858msgid "WEBSITE" 2859msgstr "" 2860 2861#. Tag: literal 2862#: index.docbook:828 2863#, no-c-format 2864msgid "WM/AuthorURL" 2865msgstr "" 2866 2867#. Tag: literal 2868#: index.docbook:828 2869#, no-c-format 2870msgid "IBSU" 2871msgstr "" 2872 2873#. Tag: entry 2874#: index.docbook:829 2875#, no-c-format 2876msgid "Work" 2877msgstr "" 2878 2879#. Tag: literal 2880#: index.docbook:829 2881#, no-c-format 2882msgid "TIT1" 2883msgstr "" 2884 2885#. Tag: literal 2886#: index.docbook:829 2887#, no-c-format 2888msgid "©wrk" 2889msgstr "" 2890 2891#. Tag: literal 2892#: index.docbook:829 2893#, no-c-format 2894msgid "WM/ContentGroupDescription" 2895msgstr "" 2896 2897#. Tag: literal 2898#: index.docbook:829 2899#, no-c-format 2900msgid "WORK" 2901msgstr "" 2902 2903#. Tag: entry 2904#: index.docbook:830 2905#, no-c-format 2906msgid "WWW Audio File" 2907msgstr "" 2908 2909#. Tag: literal 2910#: index.docbook:830 2911#, no-c-format 2912msgid "WOAF" 2913msgstr "" 2914 2915#. Tag: literal 2916#: index.docbook:830 2917#, no-c-format 2918msgid "WM/AudioFileURL" 2919msgstr "" 2920 2921#. Tag: literal 2922#: index.docbook:830 2923#, no-c-format 2924msgid "WWWAUDIOFILE" 2925msgstr "" 2926 2927#. Tag: entry 2928#: index.docbook:831 2929#, no-c-format 2930msgid "WWW Audio Source" 2931msgstr "" 2932 2933#. Tag: literal 2934#: index.docbook:831 2935#, no-c-format 2936msgid "WOAS" 2937msgstr "" 2938 2939#. Tag: literal 2940#: index.docbook:831 2941#, no-c-format 2942msgid "WM/AudioSourceURL" 2943msgstr "" 2944 2945#. Tag: literal 2946#: index.docbook:831 2947#, no-c-format 2948msgid "WWWAUDIOSOURCE" 2949msgstr "" 2950 2951#. Tag: para 2952#: index.docbook:836 2953#, no-c-format 2954msgid "Remarks concerning the mappings to unified frame names:" 2955msgstr "" 2956 2957#. Tag: para 2958#: index.docbook:839 2959#, no-c-format 2960msgid "" 2961"The number of unified frame names is limited by the fact that a sensible " 2962"mapping shall be possible for all supported file formats. Most tags support " 2963"frames with arbitrary names; these will be used if no specific frame is " 2964"available (<abbrev>e.g.</abbrev> the names in uppercase in the column MP4). " 2965"If no such possibility exists, some frame types may not be supported for the " 2966"format, <abbrev>e.g.</abbrev> Author and Performer for ASF (WMA)." 2967msgstr "" 2968 2969#. Tag: para 2970#: index.docbook:847 2971#, no-c-format 2972msgid "" 2973"The mappings are not chosen arbitrarily, they are geared to the usage of the " 2974"frames in other applications and devices. Thus the ID3v2 frame \"TPE2 - Band/" 2975"orchestra/accompaniment\" does not suggest its usage as Album Artist, but " 2976"this is commonly used. The actual meaning for ID3v2 on the other hand is the " 2977"reason why this frame is used for the orchestra when importing (<abbrev>e.g." 2978"</abbrev> from Discogs), although this may seem a bit strange for other tag " 2979"formats." 2980msgstr "" 2981 2982#. Tag: para 2983#: index.docbook:855 2984#, no-c-format 2985msgid "" 2986"The mappings are not always bijective. So ID3v2.3 uses an IPLS frame for " 2987"both Arranger and Performer. When reading back, both frames are displayed as " 2988"\"Arranger\"." 2989msgstr "" 2990 2991#. Tag: para 2992#: index.docbook:860 2993#, no-c-format 2994msgid "" 2995"The frames Arranger and Performer use a particular format for their " 2996"contents: \"involvement 1|involvee 1|involvement 2|involvee 2|...\", for " 2997"instance \"Chorus Master|Ernst Dunshirn|Soprano Vocals|Anna Netrebko\". This " 2998"will create IPLS (ID3v2.3) or TIPL/TMCL (ID3v2.4) frames with a string list " 2999"in the specified format (the \"|\" is used as a separator between the " 3000"strings). Values in this format are also set when importing data from " 3001"servers which offer this information." 3002msgstr "" 3003 3004#. Tag: para 3005#: index.docbook:869 3006#, no-c-format 3007msgid "" 3008"To explicitly use a specific frame name which conflicts with a unified frame " 3009"name, prepend an exclamation mark. For example, adding a frame of type " 3010"\"<replaceable>Media</replaceable>\" to a Vorbis comment will create a frame " 3011"with name \"<literal>SOURCEMEDIA</literal>\" because of the unified type " 3012"mapping. In order to add a frame with name \"<literal>MEDIA</literal>\" and " 3013"not \"<literal>SOURCEMEDIA</literal>\", use \"<literal>!MEDIA</literal>\" to " 3014"force the explicit name." 3015msgstr "" 3016 3017#. Tag: title 3018#: index.docbook:885 3019#, no-c-format 3020msgid "Synchronized Lyrics and Event Timing Codes" 3021msgstr "" 3022 3023#. Tag: para 3024#: index.docbook:887 3025#, no-c-format 3026msgid "" 3027"For information synchronized with the audio data, a specific editor is " 3028"available. These frames are supported for ID3v2.3.0 and ID3v2.4.0 tags. To " 3029"add such a frame, the specific frame name has to be selected in the list " 3030"which appears when the <guibutton>Add</guibutton> button is clicked - " 3031"<guilabel>Synchronized Lyrics</guilabel> or <guilabel>Event Timing Codes</" 3032"guilabel>, respectively. The editor is the same for both types, for the " 3033"event timing codes, only a predefined set of events is available whereas for " 3034"the synchronized lyrics, text has to be entered. In the following, editing " 3035"synchronized lyrics is explained." 3036msgstr "" 3037 3038#. Tag: para 3039#: index.docbook:898 3040#, no-c-format 3041msgid "" 3042"A file having an ID3v2 tag is selected, the lyrics editor is entered using " 3043"<guibutton>Add</guibutton> and selecting <guilabel>Synchronized Lyrics</" 3044"guilabel>. For an existing Synchronized Lyrics frame, it is selected and " 3045"<guibutton>Edit</guibutton> is clicked. The player is automatically opened " 3046"with the current file so that the file can be played and paused to " 3047"synchronize lyrics." 3048msgstr "" 3049 3050#. Tag: para 3051#: index.docbook:906 3052#, no-c-format 3053msgid "" 3054"The settings at the top of the SYLT editor normally do not have to be " 3055"changed. If the lyrics contains characters which are not present in the " 3056"Latin 1 character set, changing the text encoding to UTF16 (or UTF8 for " 3057"ID3v2.4.0) is advisable. For English lyrics and maximum compatibility, " 3058"ISO-8859-1 should be used." 3059msgstr "" 3060 3061#. Tag: para 3062#: index.docbook:913 3063#, no-c-format 3064msgid "" 3065"The <guilabel>Lyrics</guilabel> section has five buttons at the top. " 3066"<guibutton>Add</guibutton> will add a new time event in the table. The time " 3067"is taken from the position of the player, thus adding an entry while playing " 3068"the track will add a line for the currently played position. The events in " 3069"the table have to be chronologically ordered, therefore the row will be " 3070"inserted accordingly. Entries with an invalid time are treated specially: If " 3071"the currently selected row has an invalid time, its time stamp will be " 3072"replaced by the current time instead of adding a new row. If the current " 3073"time is not invalid, the first row with an invalid time will be used if " 3074"present. This behavior should facilitate adding time stamps if the lyrics " 3075"text is already in the table but the time stamps are missing (which is the " 3076"case when importing unsynchronized lyrics). Note that the invalid time is " 3077"represented as 00:00.00, <abbrev>i.e.</abbrev> the same as the time at the " 3078"absolute beginning of the track, which is not invalid. To make a time " 3079"invalid, press the <keycap>Delete</keycap> key, or use <guimenu>Clear</" 3080"guimenu> from the context menu. New rows inserted using <guimenu>Insert row</" 3081"guimenu> from the context menu or created when importing unsynchronized " 3082"lyrics with <guibutton>From Clipboard</guibutton> or <guibutton>Import</" 3083"guibutton> also contain invalid time stamps. Rows in the table can be " 3084"deleted by clicking the <guibutton>Delete</guibutton> button or using " 3085"<guimenu>Delete rows</guimenu> from the context menu." 3086msgstr "" 3087 3088#. Tag: para 3089#: index.docbook:935 3090#, no-c-format 3091msgid "" 3092"Synchronized lyrics can be imported from a file using <guibutton>Import</" 3093"guibutton>. The expected format is simple or enhanced LRC. If the selected " 3094"file does not contain a square bracket in the first line, it is supposed to " 3095"be a simple text file with unsynchronized lyrics. The lines from such a file " 3096"are then imported having invalid time stamps. The time information can be " 3097"added using the <guibutton>Add</guibutton> button or by manual entry. It is " 3098"also possible to import lyrics via copy-paste using <guilabel>From " 3099"Clipboard</guilabel>. Synchronized lyrics can be written to LRC files using " 3100"<guibutton>Export</guibutton>. Note that only entries with valid time stamps " 3101"will be exported and that the entries will be sorted by time. Entries with " 3102"invalid time won't be stored in the SYLT frame either, so make sure to " 3103"include all timing information before leaving the dialog." 3104msgstr "" 3105 3106#. Tag: para 3107#: index.docbook:949 3108#, no-c-format 3109msgid "" 3110"The <ulink url=\"http://id3.org/id3v2.4.0-frames\">ID3 specification</ulink> " 3111"suggests a time stamp for each syllable. However most players only support " 3112"the granularity of a line or sentence. To support both use cases, &kid3; " 3113"follows the same conventions as <ulink url=\"http://www.compuphase.com/" 3114"software_sylteditor.htm\">SYLT Editor</ulink>. Text which is entered into " 3115"the table is assumed to start a new line unless it starts with a space or a " 3116"hyphen. Exceptions to this rule are possible by starting a line with an " 3117"underscore ('_') to force continuation or a hash mark ('#') to force a new " 3118"line. These escape characters are not stored inside the SYLT frame. Inside " 3119"the SYLT frame, new lines start with a line feed character (hex 0A) whereas " 3120"continuations do not. When reading SYLT frames, &kid3; checks if the first " 3121"entry starts with a line feed. If this is not the case, it is assumed that " 3122"all entries are new lines and that no syllable continuations are used." 3123msgstr "" 3124 3125#. Tag: para 3126#: index.docbook:965 3127#, no-c-format 3128msgid "" 3129"While the track is played, the row associated with the current playing " 3130"position is highlighted, so that the correctness of the synchronization " 3131"information can be verified. If an offset has to be added to one or more " 3132"time stamps, this can be accomplished with the <guimenu>Add offset</guimenu> " 3133"context menu. Negative values can be used to reduce the time. Using " 3134"<guimenu>Seek to position</guimenu> in the context menu, it is possible to " 3135"set the playing position to the time of the selected row." 3136msgstr "" 3137 3138#. Tag: emphasis 3139#: index.docbook:975 3140#, no-c-format 3141msgid "Recommended procedure to add new synchronized lyrics" 3142msgstr "" 3143 3144#. Tag: para 3145#: index.docbook:977 3146#, no-c-format 3147msgid "" 3148"Get the unsynchronized lyrics, <abbrev>e.g.</abbrev> using " 3149"<menuchoice><guimenu>Lyrics</guimenu><guimenuitem>Embed Lyrics</" 3150"guimenuitem></menuchoice> from the file list context menu." 3151msgstr "" 3152 3153#. Tag: para 3154#: index.docbook:981 3155#, no-c-format 3156msgid "" 3157"Copy the unsynchronized lyrics to the clipboard, just go to the " 3158"<guilabel>Lyrics</guilabel> row in the frame table and press <keycombo>&Ctrl;" 3159"<keycap>C</keycap></keycombo>." 3160msgstr "" 3161 3162#. Tag: para 3163#: index.docbook:984 3164#, no-c-format 3165msgid "" 3166"Add a synchronized lyrics frame (<guibutton>Add...</guibutton>, " 3167"<guilabel>Synchronized Lyrics</guilabel>, <guibutton>OK</guibutton>), click " 3168"<guibutton>From Clipboard</guibutton>." 3169msgstr "" 3170 3171#. Tag: para 3172#: index.docbook:988 3173#, no-c-format 3174msgid "" 3175"Now all lines from the unsynchronized lyrics are in the table, all time " 3176"stamps are invalid (0:0:0.00). You can delete empty entries beforehand." 3177msgstr "" 3178 3179#. Tag: para 3180#: index.docbook:991 3181#, no-c-format 3182msgid "" 3183"Start playing the song by clicking the play button <guibutton>►</" 3184"guibutton> in the play toolbar at the bottom of the main window." 3185msgstr "" 3186 3187#. Tag: para 3188#: index.docbook:994 3189#, no-c-format 3190msgid "" 3191"When the next lyrics line with invalid timestamp comes, click " 3192"<guibutton>Add</guibutton> or press <keycombo>&Alt;<keycap>A</keycap></" 3193"keycombo>, the timestamp will be updated." 3194msgstr "" 3195 3196#. Tag: para 3197#: index.docbook:998 3198#, no-c-format 3199msgid "" 3200"Continue like this until all timestamps are set. If you missed something, " 3201"stop playback and clear the timestamps using the <keycap>Delete</keycap> key " 3202"or by selecting them and using <guimenuitem>Clear</guimenuitem> from the " 3203"context menu. To restart playback from a given timestamp, use " 3204"<guimenuitem>Seek to position</guimenuitem> from the context menu." 3205msgstr "" 3206 3207#. Tag: title 3208#: index.docbook:1011 3209#, no-c-format 3210msgid "The File Menu" 3211msgstr "" 3212 3213#. Tag: menuchoice 3214#: index.docbook:1016 3215#, no-c-format 3216msgid "" 3217"<shortcut> <keycombo>&Ctrl;<keycap>O</keycap></keycombo> </shortcut> " 3218"<guimenu>File</guimenu> <guimenuitem>Open...</guimenuitem>" 3219msgstr "" 3220 3221#. Tag: para 3222#: index.docbook:1023 3223#, no-c-format 3224msgid "" 3225"<action>Opens a folder.</action> All files matching the selected file name " 3226"filter will be displayed in the file listbox and the chosen file is selected." 3227msgstr "" 3228 3229#. Tag: menuchoice 3230#: index.docbook:1029 3231#, no-c-format 3232msgid "<guimenu>File</guimenu> <guimenuitem>Open Recent</guimenuitem>" 3233msgstr "" 3234 3235#. Tag: action 3236#: index.docbook:1033 3237#, no-c-format 3238msgid "Opens a recently opened folder." 3239msgstr "" 3240 3241#. Tag: menuchoice 3242#: index.docbook:1037 3243#, no-c-format 3244msgid "" 3245"<shortcut> <keycombo>&Ctrl;<keycap>D</keycap></keycombo> </shortcut> " 3246"<guimenu>File</guimenu> <guimenuitem>Open Folder...</guimenuitem>" 3247msgstr "" 3248 3249#. Tag: para 3250#: index.docbook:1044 3251#, no-c-format 3252msgid "" 3253"<action>Opens a folder.</action> All files matching the selected file name " 3254"filter will be displayed in the file listbox." 3255msgstr "" 3256 3257#. Tag: menuchoice 3258#: index.docbook:1049 3259#, no-c-format 3260msgid "" 3261"<shortcut> <keycap>F5</keycap> </shortcut> <guimenu>File</guimenu> " 3262"<guimenuitem>Reload</guimenuitem>" 3263msgstr "" 3264 3265#. Tag: para 3266#: index.docbook:1056 3267#, no-c-format 3268msgid "" 3269"<action>Reload folder.</action> Modified files have to be saved before. " 3270"Expanded subfolders will be collapsed." 3271msgstr "" 3272 3273#. Tag: menuchoice 3274#: index.docbook:1061 3275#, no-c-format 3276msgid "" 3277"<shortcut> <keycombo>&Ctrl;<keycap>S</keycap></keycombo> </shortcut> " 3278"<guimenu>File</guimenu> <guimenuitem>Save</guimenuitem>" 3279msgstr "" 3280 3281#. Tag: para 3282#: index.docbook:1068 3283#, no-c-format 3284msgid "" 3285"<action>Saves all changed files in the folder.</action> The changed files " 3286"are marked with a disk symbol in the file listbox. If any file names have " 3287"been changed, those files will be renamed." 3288msgstr "" 3289 3290#. Tag: menuchoice 3291#: index.docbook:1074 3292#, no-c-format 3293msgid "<guimenu>File</guimenu> <guimenuitem>Revert</guimenuitem>" 3294msgstr "" 3295 3296#. Tag: para 3297#: index.docbook:1078 3298#, no-c-format 3299msgid "" 3300"<action>Reverts the changes of one or multiple files.</action> If no files " 3301"are selected in the file listbox, the changes of all files will be reverted, " 3302"else only the changes of the selected files are reverted." 3303msgstr "" 3304 3305#. Tag: menuchoice 3306#: index.docbook:1085 3307#, no-c-format 3308msgid "<guimenu>File</guimenu> <guimenuitem>Import...</guimenuitem>" 3309msgstr "" 3310 3311#. Tag: para 3312#: index.docbook:1089 3313#, no-c-format 3314msgid "" 3315"The <action>Import dialog</action> can be used to import data directly from " 3316"a freedb.org server, from a MusicBrainz server, from Discogs, Amazon or " 3317"other sources of album track lists in textual format." 3318msgstr "" 3319 3320#. Tag: para 3321#: index.docbook:1093 3322#, no-c-format 3323msgid "" 3324"Import from a freedb.org server is possible using a dialog which appears " 3325"when <guibutton>From Server:</guibutton> <guibutton>gnudb.org</guibutton> is " 3326"selected. The artist and album name to search for can be entered in the two " 3327"topmost fields, the albums which match the query will be displayed when " 3328"<guibutton>Find</guibutton> is clicked and the results from <ulink url=" 3329"\"http://www.gnudb.org\">www.gnudb.org</ulink> are received. Importing the " 3330"track data for an album is done by double-clicking the album in the list. " 3331"The freedb.org server to import from can be selected as well as the CGI " 3332"path. The imported data is displayed in the preview table of the import " 3333"dialog. When satisfied with the displayed tracks, they can be imported by " 3334"terminating the import dialog with <guibutton>OK</guibutton>." 3335msgstr "" 3336 3337#. Tag: para 3338#: index.docbook:1110 3339#, no-c-format 3340msgid "" 3341"A search on the Discogs server can be performed using <guibutton>Discogs</" 3342"guibutton>. As in the <guibutton>gnudb.org</guibutton> dialog, you can enter " 3343"artist and album and then choose from a list of releases. A <guilabel>Token</" 3344"guilabel> can be entered to use the RESTful Discogs API instead of their web " 3345"interface, which is often changed, thereby breaking the import parser. You " 3346"have to register for an account on <ulink url=\"https://www.discogs.com/" 3347"\">Discogs</ulink> and then generate a token on their web site (Settings/" 3348"Developers, Generate new token). Don't forget to <guibutton>Save Settings</" 3349"guibutton> after entering the token in order to use it in subsequent " 3350"requests too. If <guilabel>Standard Tags</guilabel> is marked, the standard " 3351"information is imported, <abbrev>e.g.</abbrev> artist, album, and title. If " 3352"<guilabel>Additional Tags</guilabel> is marked, more information is imported " 3353"if available, <abbrev>e.g.</abbrev> performers, arrangers, or the publisher. " 3354"If <guilabel>Cover Art</guilabel> is marked, cover art will be downloaded if " 3355"available." 3356msgstr "" 3357 3358#. Tag: para 3359#: index.docbook:1128 3360#, no-c-format 3361msgid "" 3362"A search on Amazon can be performed using <guibutton>Amazon</guibutton>. As " 3363"in the <guibutton>gnudb.org</guibutton> dialog, you can enter artist and " 3364"album and then choose from a list of releases. If <guilabel>Additional Tags</" 3365"guilabel> is marked, more information is imported if available, <abbrev>e.g." 3366"</abbrev> performers, arrangers, or the publisher. If <guilabel>Cover Art</" 3367"guilabel> is marked, cover art will be downloaded if available." 3368msgstr "" 3369 3370#. Tag: para 3371#: index.docbook:1137 3372#, no-c-format 3373msgid "" 3374"You can search in the same way in the release database of MusicBrainz using " 3375"<guibutton>From MusicBrainz Release</guibutton>. The workflow is the same as " 3376"described for <guibutton>From gnudb.org</guibutton>." 3377msgstr "" 3378 3379#. Tag: para 3380#: index.docbook:1143 3381#, no-c-format 3382msgid "" 3383"Import from a MusicBrainz server is possible using the dialog which appears " 3384"when <guibutton>From MusicBrainz Fingerprint</guibutton> is selected. The " 3385"Server can be selected as in the freedb import dialog. Below is a table " 3386"displaying the imported track data. The right column shows the state of the " 3387"MusicBrainz query, which starts with \"Pending\" when the dialog is opened. " 3388"Then the fingerprint is looked up and if it does not yield a result, another " 3389"lookup using the tags in the file is tried. Thus it can be helpful for a " 3390"successful MusicBrainz query to store known information (<abbrev>e.g.</" 3391"abbrev> artist and album) in the tags before the import. If a result was " 3392"found, the search ends in the state \"Recognized\", otherwise nothing was " 3393"found or multiple ambiguous results and one of them has to be selected by " 3394"the user. <guibutton>OK</guibutton> and <guibutton>Apply</guibutton> use the " 3395"imported data, <guibutton>Cancel</guibutton> closes the dialog. The closing " 3396"can take a while since the whole MusicBrainz machinery has to be shut down." 3397msgstr "" 3398 3399#. Tag: para 3400#: index.docbook:1160 3401#, no-c-format 3402msgid "" 3403"For the import of textual data, <guibutton>From File/Clipboard</guibutton> " 3404"opens a subdialog, where several preconfigured import formats are available. " 3405"The first two, \"CSV unquoted\" and \"CSV quoted\" can be used to import " 3406"data which was exported by the Export dialog. The CSV data can be edited " 3407"with a spreadsheet, and shall be written using tabs as delimiters. Import " 3408"should then be possible using \"CSV quoted\", which is more flexible than " 3409"\"CSV unquoted\". However, its fields cannot contain any double quotes. If " 3410"you only export from &kid3; and import later, \"CSV unquoted\" can be used " 3411"as a simple format for this purpose. Note that there are also \"Export CSV\" " 3412"and \"Import CSV\" commands in the context menu of the file list, which use " 3413"scripts to export and import CSV data in a more complete, powerful and " 3414"flexible way." 3415msgstr "" 3416 3417#. Tag: para 3418#: index.docbook:1175 3419#, no-c-format 3420msgid "" 3421"The next format, \"freedb &HTML; text\", can be used to copy information " 3422"from an &HTML; page of <ulink url=\"http://freedb.org\">freedb.org</ulink>. " 3423"Search an album in freedb and if the desired information is displayed in the " 3424"web browser, copy the contents to the clipboard. Then click the " 3425"<guibutton>From Clipboard</guibutton> button and the imported tracks will be " 3426"displayed in the preview table at the top of the dialog. If you are " 3427"satisfied with the imported data, terminate the dialog with <guibutton>OK</" 3428"guibutton>, which will insert the data into the tags of the current folder. " 3429"The destination (<guilabel>Tag 1</guilabel>, <guilabel>Tag 2</guilabel> or " 3430"<guilabel>Tag 1 and Tag 2</guilabel>) can be selected with a combo box. The " 3431"files in the current folder should be in the correct track order to get " 3432"their tags assigned. This is the case if they are numbered." 3433msgstr "" 3434 3435#. Tag: para 3436#: index.docbook:1190 3437#, no-c-format 3438msgid "" 3439"The next preconfigured import format, \"freedb &HTML; source\", can be used, " 3440"if the data is available as an &HTML; document. Import is possible using the " 3441"<guibutton>From File</guibutton> button, which opens a file selector, or " 3442"copying its contents from an editor and then importing from clipboard. This " 3443"format can be useful for offline import, although the &HTML; document could " 3444"also be opened in a browser and then be imported in the first format via the " 3445"clipboard." 3446msgstr "" 3447 3448#. Tag: para 3449#: index.docbook:1198 3450#, no-c-format 3451msgid "" 3452"More preconfigured formats, <abbrev>e.g.</abbrev> \"Track Title Time\", are " 3453"available. An empty custom format can be created with <guibutton>Add</" 3454"guibutton> to be set by the user. Two lines below the format name can be set " 3455"with a regular expression to capture the fields from the import text. The " 3456"first regular expression will be parsed once per document to gather per-" 3457"album data such as artist, album, year and genre. The second line is tried " 3458"to match from the start of the document to the end to get track data, " 3459"usually number and title. The regular expressions include all the features " 3460"offered by &Qt;, which is most of the what Perl offers. Bracketing " 3461"constructs \"(..)\" create capture buffers for the fields to import and are " 3462"preceded by &kid3; specific codes to specify which field to capture. The " 3463"codes are the same as used for the filename format, besides the codes listed " 3464"below, any frame name is possible:" 3465msgstr "" 3466 3467#. Tag: para 3468#: index.docbook:1221 3469#, no-c-format 3470msgid "%t %{track} Track" 3471msgstr "" 3472 3473#. Tag: para 3474#: index.docbook:1223 3475#, no-c-format 3476msgid "%d %{duration} Duration" 3477msgstr "" 3478 3479#. Tag: para 3480#: index.docbook:1227 3481#, no-c-format 3482msgid "" 3483"For example, a track regular expression (second line) to import from an " 3484"<filename class=\"extension\">.m3u</filename> playlist could be \"<literal>" 3485"%{track}(\\d+)\\s+%{title}(\\S[^\\r\\n]*)\\.mp3[\\r\\n]</literal>\". All " 3486"formats can be changed by editing the regular expressions and the name and " 3487"then clicking <guibutton>Save Settings</guibutton>. They will be stored in " 3488"the <filename>kid3rc</filename> file in the configuration folder. This file " 3489"can be directly edited to have more import formats or it can be deleted to " 3490"revert to the default formats. Formats can be deleted using " 3491"<guibutton>Remove</guibutton>." 3492msgstr "" 3493 3494#. Tag: para 3495#: index.docbook:1237 3496#, no-c-format 3497msgid "" 3498"<guilabel>Accuracy</guilabel> shows an estimation of how good the imported " 3499"information matches the given tracks. It uses track durations or file names " 3500"to calculate the level of similarity in percent. <guilabel>Cover Art</" 3501"guilabel> shows the &URL; of the album cover image which will be downloaded." 3502msgstr "" 3503 3504#. Tag: para 3505#: index.docbook:1244 3506#, no-c-format 3507msgid "" 3508"To check whether the imported tracks match the current set of files, the " 3509"duration of the imported tracks can be compared with the duration of the " 3510"files. This option can be enabled with the check box <guibutton>Check " 3511"maximum allowable time difference (sec):</guibutton> and the maximum " 3512"tolerated difference in time can be set in seconds. If a mismatch in a " 3513"length is detected, the length is displayed with a red background in the " 3514"preview table." 3515msgstr "" 3516 3517#. Tag: para 3518#: index.docbook:1252 3519#, no-c-format 3520msgid "" 3521"If the files are ordered differently than the imported tracks, their " 3522"assigned tracks have to be changed. This task can be facilitated using the " 3523"<guilabel>Match with</guilabel> option with the buttons <guibutton>Length</" 3524"guibutton>, <guibutton>Track</guibutton>, and <guibutton>Title</guibutton>, " 3525"which will reorder the tracks according to the corresponding field. To " 3526"correct the assignments manually, a track can be dragged with the " 3527"<mousebutton>left</mousebutton> mouse button and the &Ctrl; key hold down, " 3528"and then dropped at the new location." 3529msgstr "" 3530 3531#. Tag: para 3532#: index.docbook:1261 3533#, no-c-format 3534msgid "" 3535"When the import dialog is opened, it contains the actual contents of the " 3536"tags. The tag type (Tag 1, Tag 2, Tag 1 and Tag 2) can be selected using the " 3537"<guilabel>Destination</guilabel> combo box. The button on the right of this " 3538"combo box can be used to revert the table to the current contents of the " 3539"tags. The check boxes in the first table column can be used to select the " 3540"tracks which are imported. This can be useful if a folder contains the " 3541"tracks of both &CD;s of a double &CD; and only the tracks of the second &CD; " 3542"have to be imported." 3543msgstr "" 3544 3545#. Tag: para 3546#: index.docbook:1271 3547#, no-c-format 3548msgid "" 3549"To identify the tracks which are imported, it is possible to display the " 3550"file names or the full paths to the files using the context menu of the " 3551"table header. The values in the import table can be edited. The revert-" 3552"button to the right of the <guilabel>Destination</guilabel> combo box can be " 3553"used to restore the contents of the tags, which can also be useful after " 3554"changing the <guilabel>Destination</guilabel>." 3555msgstr "" 3556 3557#. Tag: para 3558#: index.docbook:1279 3559#, no-c-format 3560msgid "" 3561"Almost all dialogs feature a <guibutton>Save Settings</guibutton> button, " 3562"which can be used to store the dialog specific settings and the window size " 3563"persistently." 3564msgstr "" 3565 3566#. Tag: para 3567#: index.docbook:1285 3568#, no-c-format 3569msgid "" 3570"<guibutton>From Tags</guibutton> leads to a subdialog to set tag frames from " 3571"the contents of other tag frames. This can be used to simply copy " 3572"information between tags or extract a part from one frame and insert it in " 3573"another." 3574msgstr "" 3575 3576#. Tag: para 3577#: index.docbook:1290 3578#, no-c-format 3579msgid "" 3580"As in the <link linkend=\"import-text\">import from file/clipboard</link> " 3581"dialog, there are freely configurable formats to perform different " 3582"operations. Already preconfigured are formats to copy the Album value to " 3583"Album Artist, Composer or Conductor, and to extract the Track Number from " 3584"Title fields which contain a number. There is also a format to extract a " 3585"Subtitle from a Title field." 3586msgstr "" 3587 3588#. Tag: para 3589#: index.docbook:1297 3590#, no-c-format 3591msgid "" 3592"The following example explains how to add a custom format, which sets the " 3593"information from the Subtitle field also in the Comment field. Create a new " 3594"format using <guibutton>Add</guibutton> button and set a new name, <abbrev>e." 3595"g.</abbrev> \"Subtitle to Comment\". Then enter \"<userinput>%{subtitle}</" 3596"userinput>\" in <guilabel>Source</guilabel> and \"<userinput>%{comment}(.*)</" 3597"userinput>\" for <guilabel>Extraction</guilabel> and click <guibutton>Save " 3598"Settings</guibutton>." 3599msgstr "" 3600 3601#. Tag: para 3602#: index.docbook:1306 3603#, no-c-format 3604msgid "" 3605"The expression in <guilabel>Source</guilabel> can contain <link linkend=" 3606"\"format-codes\">format codes</link> for arbitrary tag frames, multiple " 3607"codes can be used to combine the contents from different frames. For each " 3608"track, a text is generated from its tags using the <guilabel>Source </" 3609"guilabel> format, and the regular expression from <guilabel>Extraction</" 3610"guilabel> is applied to this text to set new values for the tags. Format " 3611"codes are used before the capturing parentheses to specify the tag frame " 3612"where the captured text shall be stored. It works in the same way as for the " 3613"<link linkend=\"import-text\">import from file/clipboard</link>." 3614msgstr "" 3615 3616#. Tag: para 3617#: index.docbook:1317 3618#, no-c-format 3619msgid "" 3620"<guimenuitem>Import from Tags...</guimenuitem> is also directly available " 3621"from the <guimenu>File</guimenu> menu. The difference between these two " 3622"functions is that the import dialog subdialog operates on all files of the " 3623"current folder whereas the menu function operates on the selected files " 3624"(which can be in different folders). The menu function supports an " 3625"additional code \"<literal>%{__return}</literal>\" to return the extracted " 3626"value, which can be useful with the CLI and QML interfaces." 3627msgstr "" 3628 3629#. Tag: menuchoice 3630#: index.docbook:1330 3631#, no-c-format 3632msgid "" 3633"<guimenu>File</guimenu> <guimenuitem>Import from gnudb.org...</guimenuitem>" 3634msgstr "" 3635 3636#. Tag: para 3637#: index.docbook:1334 3638#, no-c-format 3639msgid "" 3640"<action>Import from a freedb.org server using gnudb.org album search.</" 3641"action> This menu item opens the same import dialog as <guimenuitem>Import..." 3642"</guimenuitem>, but opens directly the <guibutton>gnudb.org</guibutton> " 3643"dialog." 3644msgstr "" 3645 3646#. Tag: menuchoice 3647#: index.docbook:1342 3648#, no-c-format 3649msgid "" 3650"<guimenu>File</guimenu> <guimenuitem>Import from Discogs...</guimenuitem>" 3651msgstr "" 3652 3653#. Tag: para 3654#: index.docbook:1346 3655#, no-c-format 3656msgid "" 3657"<action>Import from the Discogs server.</action> This menu item opens the " 3658"same import dialog as <guimenuitem>Import...</guimenuitem>, but opens " 3659"directly the <guibutton>From Discogs</guibutton> dialog." 3660msgstr "" 3661 3662#. Tag: menuchoice 3663#: index.docbook:1354 3664#, no-c-format 3665msgid "" 3666"<guimenu>File</guimenu> <guimenuitem>Import from Amazon...</guimenuitem>" 3667msgstr "" 3668 3669#. Tag: para 3670#: index.docbook:1358 3671#, no-c-format 3672msgid "" 3673"<action>Import from Amazon.</action> This menu item opens the same import " 3674"dialog as <guimenuitem>Import...</guimenuitem>, but opens directly the " 3675"<guibutton>From Amazon</guibutton> dialog." 3676msgstr "" 3677 3678#. Tag: menuchoice 3679#: index.docbook:1366 3680#, no-c-format 3681msgid "" 3682"<guimenu>File</guimenu> <guimenuitem>Import from MusicBrainz Release...</" 3683"guimenuitem>" 3684msgstr "" 3685 3686#. Tag: para 3687#: index.docbook:1370 3688#, no-c-format 3689msgid "" 3690"<action>Import from the MusicBrainz release database.</action> This menu " 3691"item opens the same import dialog as <guimenuitem>Import...</guimenuitem>, " 3692"but opens directly the <guibutton>From MusicBrainz Release</guibutton> " 3693"dialog." 3694msgstr "" 3695 3696#. Tag: menuchoice 3697#: index.docbook:1378 3698#, no-c-format 3699msgid "" 3700"<guimenu>File</guimenu> <guimenuitem>Import from MusicBrainz Fingerprint...</" 3701"guimenuitem>" 3702msgstr "" 3703 3704#. Tag: para 3705#: index.docbook:1382 3706#, no-c-format 3707msgid "" 3708"<action>Import from a MusicBrainz server.</action> This menu item opens the " 3709"same import dialog as <guimenuitem>Import...</guimenuitem>, but opens " 3710"directly the <guibutton>From MusicBrainz Fingerprint</guibutton> dialog." 3711msgstr "" 3712 3713#. Tag: menuchoice 3714#: index.docbook:1389 3715#, no-c-format 3716msgid "<guimenu>File</guimenu> <guimenuitem>Import from Tags...</guimenuitem>" 3717msgstr "" 3718 3719#. Tag: para 3720#: index.docbook:1393 3721#, no-c-format 3722msgid "" 3723"Like <link linkend=\"import-tags\">From Tags</link>, but the import is " 3724"applied to the selected files." 3725msgstr "" 3726 3727#. Tag: menuchoice 3728#: index.docbook:1398 3729#, no-c-format 3730msgid "<guimenu>File</guimenu> <guimenuitem>Automatic Import...</guimenuitem>" 3731msgstr "" 3732 3733#. Tag: para 3734#: index.docbook:1402 3735#, no-c-format 3736msgid "" 3737"<action>Automatic Import</action> allows one to import information for " 3738"multiple albums from various web services. If folders are selected in the " 3739"file list, track data for the selected folders will be imported. If no " 3740"folder is selected, all folders in the file list will be imported." 3741msgstr "" 3742 3743#. Tag: para 3744#: index.docbook:1408 3745#, no-c-format 3746msgid "" 3747"The tag type (Tag 1, Tag 2, Tag 1 and Tag 2) can be selected using the " 3748"<guilabel>Destination</guilabel> combo box." 3749msgstr "" 3750 3751#. Tag: para 3752#: index.docbook:1412 3753#, no-c-format 3754msgid "" 3755"Profiles determine which servers will be contacted to fetch album " 3756"information. Some profiles are predefined (All, MusicBrainz, Discogs, Cover " 3757"Art), custom profiles can be added using the <guibutton>Add</guibutton> " 3758"button at the right of the <guilabel>Profile</guilabel> combo box." 3759msgstr "" 3760 3761#. Tag: para 3762#: index.docbook:1419 3763#, no-c-format 3764msgid "" 3765"The table below shows the servers which will be used when importing album " 3766"information using the selected profile. The import process for an album is " 3767"finished if all required information has been found, so the order of the " 3768"rows in the table is important. It can be changed using the <guibutton>Move " 3769"Up</guibutton> and <guibutton>Move Down</guibutton> buttons. " 3770"<guibutton>Edit</guibutton> can be used to change an existing entry. The " 3771"<guibutton>Server</guibutton> selection offers the same servers as can be " 3772"used in the import functions. <guilabel>Standard Tags</guilabel>, " 3773"<guilabel>Additional Tags</guilabel>, <guilabel>Cover Art</guilabel> " 3774"determine the information which shall be fetched from the server. Finally, " 3775"<guilabel>Accuracy</guilabel> is the minimum accuracy which must be achieved " 3776"to accept the imported data. If the accuracy is insufficient, the next " 3777"server in the list will be tried. The same dialog containing the server " 3778"properties appears when <guibutton>Add</guibutton> is clicked to add a new " 3779"server entry. Existing entries can be deleted using <guibutton>Remove</" 3780"guibutton>." 3781msgstr "" 3782 3783#. Tag: para 3784#: index.docbook:1437 3785#, no-c-format 3786msgid "" 3787"To launch an automatic batch import with the selected profile, click " 3788"<guibutton>Start</guibutton>. Details about the running import are displayed " 3789"at the top of the dialog. The process can be aborted with the " 3790"<guibutton>Abort</guibutton> button." 3791msgstr "" 3792 3793#. Tag: menuchoice 3794#: index.docbook:1448 3795#, no-c-format 3796msgid "<guimenu>File</guimenu> <guimenuitem>Browse Cover Art...</guimenuitem>" 3797msgstr "" 3798 3799#. Tag: para 3800#: index.docbook:1452 3801#, no-c-format 3802msgid "" 3803"The <action>Browse Cover Art</action> dialog helps to find album cover art. " 3804"<guilabel>Artist/Album</guilabel> is filled from the tags if possible. " 3805"<guilabel>Source</guilabel> offers a variety of websites with album cover " 3806"art. The &URL; with artist and album as parameters can be found beneath the " 3807"name. &URL;-encoded values for artist and album can be inserted using " 3808"\"<userinput>%u{artist}</userinput>\" and \"<userinput>%u{album}</userinput>" 3809"\", other values from the tags are possible too, as described in <link " 3810"linkend=\"configure-kid3\">Configure &kid3;</link>, <guilabel>User Actions</" 3811"guilabel>. More sources can be entered after the entry \"Custom Source\" by " 3812"replacing \"Custom Source\" with the source's name, pressing <keycap>Enter</" 3813"keycap>, then inserting the &URL; and finally pressing <guibutton>Save " 3814"Settings</guibutton>. The resulting browser command is displayed at the top " 3815"of the dialog and can be started by clicking <guibutton>Browse</guibutton>. " 3816"The browser, which can be configured in the settings, is started with the " 3817"selected source. A cover image can then be dragged from the browser into the " 3818"&kid3; window and will be set in the picture frame of the selected files." 3819msgstr "" 3820 3821#. Tag: para 3822#: index.docbook:1470 3823#, no-c-format 3824msgid "" 3825"Because not all browsers support drag and drop of images and the pictures on " 3826"websites often have a &URL;, in such cases &kid3; will receive the &URL; and " 3827"not the picture. If the &URL; points to a picture, it will be downloaded. " 3828"However, if the &URL; refers to some other web resource, it has to be " 3829"translated to the corresponding picture. Such mappings are defined in the " 3830"table <guilabel>&URL; extraction</guilabel>. The left column " 3831"<guilabel>Match</guilabel> contains a regular expression which is compared " 3832"with the &URL;. If it matches, the captured expressions in parentheses are " 3833"inserted into the pattern of the right <guilabel>Picture &URL;</guilabel> " 3834"column (at the positions marked with \\1 <abbrev>etc.</abbrev>). The " 3835"replaced regular expression contains the &URL; of the picture. By this means " 3836"cover art can be imported from Amazon, Google Images, <abbrev>etc.</abbrev> " 3837"using drag and drop. It is also possible to define your own mappings." 3838msgstr "" 3839 3840#. Tag: menuchoice 3841#: index.docbook:1488 3842#, no-c-format 3843msgid "<guimenu>File</guimenu> <guimenuitem>Export...</guimenuitem>" 3844msgstr "" 3845 3846#. Tag: para 3847#: index.docbook:1492 3848#, no-c-format 3849msgid "" 3850"The <action>Export Dialog</action> is used to store data from the tags in a " 3851"file or the clipboard. The editor at the top shows a preview of the data to " 3852"export. If the export data contain tabulator characters, the export is " 3853"displayed in a table. The data will be generated from the tags in the " 3854"current folder according to the configured format." 3855msgstr "" 3856 3857#. Tag: para 3858#: index.docbook:1499 3859#, no-c-format 3860msgid "" 3861"The format settings are similar as in the Import dialog: The topmost field " 3862"contains the title (<abbrev>e.g.</abbrev> \"CSV unquoted\"), followed by the " 3863"header, which will be generated at the begin of the file. The track data " 3864"follows; it is used for every track. Finally, the trailer can be used to " 3865"generate some finishing text." 3866msgstr "" 3867 3868#. Tag: para 3869#: index.docbook:1506 3870#, no-c-format 3871msgid "" 3872"The format fields do not contain regular expressions as in the Import " 3873"dialog, but only output format expressions with special %-expressions, which " 3874"will be replaced by values from the tags. The whole thing works like the " 3875"file name format, and the same codes are used plus some additional codes. " 3876"Not only the codes listed below but all tag frame names can be used." 3877msgstr "" 3878 3879#. Tag: para 3880#: index.docbook:1524 index.docbook:1904 3881#, no-c-format 3882msgid "%f %{file} File name" 3883msgstr "" 3884 3885#. Tag: para 3886#: index.docbook:1525 3887#, no-c-format 3888msgid "%p %{filepath} Path" 3889msgstr "" 3890 3891#. Tag: para 3892#: index.docbook:1526 3893#, no-c-format 3894msgid "%{modificationdate} Modification date" 3895msgstr "" 3896 3897#. Tag: para 3898#: index.docbook:1527 3899#, no-c-format 3900msgid "%{creationdate} Creation date" 3901msgstr "" 3902 3903#. Tag: para 3904#: index.docbook:1528 3905#, no-c-format 3906msgid "%u %{url} &URL;" 3907msgstr "" 3908 3909#. Tag: para 3910#: index.docbook:1529 3911#, no-c-format 3912msgid "%{dirname} Folder name" 3913msgstr "" 3914 3915#. Tag: para 3916#: index.docbook:1530 3917#, no-c-format 3918msgid "%d %{duration} Duration in minutes:seconds" 3919msgstr "" 3920 3921#. Tag: para 3922#: index.docbook:1531 3923#, no-c-format 3924msgid "%D %{seconds} Duration in seconds" 3925msgstr "" 3926 3927#. Tag: para 3928#: index.docbook:1532 3929#, no-c-format 3930msgid "%n %{tracks} Number of tracks of the album" 3931msgstr "" 3932 3933#. Tag: para 3934#: index.docbook:1533 index.docbook:1906 3935#, no-c-format 3936msgid "%e %{extension} File extension" 3937msgstr "" 3938 3939#. Tag: para 3940#: index.docbook:1534 index.docbook:1907 3941#, no-c-format 3942msgid "%O %{tag1} The format of tag 1 (ID3v1.1 or empty if not existing)" 3943msgstr "" 3944 3945#. Tag: para 3946#: index.docbook:1536 index.docbook:1909 3947#, no-c-format 3948msgid "" 3949"%o %{tag2} The format of tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1, " 3950"Vorbis, APE, MP4, ASF, or empty if not existing)" 3951msgstr "" 3952 3953#. Tag: para 3954#: index.docbook:1538 index.docbook:1911 3955#, no-c-format 3956msgid "%b %{bitrate} Bit rate in kbit/s" 3957msgstr "" 3958 3959#. Tag: para 3960#: index.docbook:1539 index.docbook:1912 3961#, no-c-format 3962msgid "%v %{vbr} VBR or empty (only for ID3v2.3 with id3lib)" 3963msgstr "" 3964 3965#. Tag: para 3966#: index.docbook:1541 index.docbook:1914 3967#, no-c-format 3968msgid "%r %{samplerate} Sample rate in Hz" 3969msgstr "" 3970 3971#. Tag: para 3972#: index.docbook:1542 index.docbook:1915 3973#, no-c-format 3974msgid "%m %{mode} Channel mode (Stereo or Joint Stereo)" 3975msgstr "" 3976 3977#. Tag: para 3978#: index.docbook:1543 index.docbook:1916 3979#, no-c-format 3980msgid "%h %{channels} Number of channels (1 or 2)" 3981msgstr "" 3982 3983#. Tag: para 3984#: index.docbook:1544 index.docbook:1917 3985#, no-c-format 3986msgid "" 3987"%k %{codec} Codec (<abbrev>e.g.</abbrev> MPEG 1 Layer 3, MP4, Ogg Vorbis, " 3988"FLAC, MPC, APE, ASF, AIFF, WAV)" 3989msgstr "" 3990 3991#. Tag: para 3992#: index.docbook:1548 3993#, no-c-format 3994msgid "" 3995"A few formats are predefined. \"CSV unquoted\" separates the fields by tabs. " 3996"Data in this format can be imported again into &kid3; using the import " 3997"format with the same name. \"CSV quoted\" additionally encloses the fields " 3998"by double quotes, which eases the import into spreadsheet applications. " 3999"However, the fields shall not contain any double quotes when this format is " 4000"used. \"Extended M3U\" and \"Extended PLS\" generate playlists with extended " 4001"attributes and absolute path names. \"HTML\" can be used to generate an " 4002"&HTML; page with hyperlinks to the tracks. \"Kover &XML;\" creates a file " 4003"which can be imported by the cover printing program Kover. \"Technical " 4004"Details\" provides information about bit rate, sample rate, channels, " 4005"<abbrev>etc.</abbrev> Finally, \"Custom Format\" is left empty for " 4006"definition of a custom format. You can define more formats of your own by " 4007"adding lines in the file <filename>kid3rc</filename> in the configuration " 4008"folder. The other formats can be adapted to your needs." 4009msgstr "" 4010 4011#. Tag: para 4012#: index.docbook:1563 4013#, no-c-format 4014msgid "" 4015"The <guilabel>Source</guilabel> of the tags to generate the export data " 4016"(<guilabel>Tag 1</guilabel> or <guilabel>Tag 2</guilabel>) can be selected " 4017"with a combo box. Pushing <guibutton>To File</guibutton> or <guibutton>To " 4018"Clipboard</guibutton> stores the data in a file or on the clipboard. " 4019"<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> close the " 4020"dialog, whereas <guibutton>OK</guibutton> accepts the current dialog " 4021"settings." 4022msgstr "" 4023 4024#. Tag: menuchoice 4025#: index.docbook:1574 4026#, no-c-format 4027msgid "<guimenu>File</guimenu> <guimenuitem>Create Playlist...</guimenuitem>" 4028msgstr "" 4029 4030#. Tag: para 4031#: index.docbook:1578 4032#, no-c-format 4033msgid "" 4034"<action>Creates a playlist.</action> The format and contents of the playlist " 4035"can be set by various options." 4036msgstr "" 4037 4038#. Tag: para 4039#: index.docbook:1581 4040#, no-c-format 4041msgid "" 4042"The name of the playlist can be the <guibutton>Same as folder name</" 4043"guibutton> or use a <guibutton>Format</guibutton> with values from the tags, " 4044"<abbrev>e.g.</abbrev> \"<userinput>%{artist} - %{album}</userinput>\" to " 4045"have the artist and album name in the playlist file name. The format codes " 4046"are the same as for <link linkend=\"export\">Export</link>. " 4047"<guibutton>Create new empty playlist</guibutton> will make an empty playlist " 4048"with the given name. The extension depends on the playlist format." 4049msgstr "" 4050 4051#. Tag: para 4052#: index.docbook:1591 4053#, no-c-format 4054msgid "" 4055"The location of the generated playlist is determined by the selection of the " 4056"<guilabel>Create in</guilabel> combo box." 4057msgstr "" 4058 4059#. Tag: term 4060#: index.docbook:1595 4061#, no-c-format 4062msgid "Current folder" 4063msgstr "" 4064 4065#. Tag: para 4066#: index.docbook:1596 4067#, no-c-format 4068msgid "" 4069"The playlist is created in the current folder and contains only files of the " 4070"current folder. The current folder is the folder where the current file is " 4071"located. If multiple files are selected, the current file is probably the " 4072"last selected file." 4073msgstr "" 4074 4075#. Tag: term 4076#: index.docbook:1600 4077#, no-c-format 4078msgid "Every folder" 4079msgstr "" 4080 4081#. Tag: para 4082#: index.docbook:1601 4083#, no-c-format 4084msgid "" 4085"A playlist is created in every folder which contains listed files, and each " 4086"playlist contains the files of that folder." 4087msgstr "" 4088 4089#. Tag: term 4090#: index.docbook:1604 4091#, no-c-format 4092msgid "Top-level folder" 4093msgstr "" 4094 4095#. Tag: para 4096#: index.docbook:1605 4097#, no-c-format 4098msgid "" 4099"Only one playlist is created in the top-level folder (<abbrev>i.e.</abbrev> " 4100"the folder of the file list) and it contains the listed files of the top-" 4101"level folder and all of its sub-folders." 4102msgstr "" 4103 4104#. Tag: para 4105#: index.docbook:1611 4106#, no-c-format 4107msgid "" 4108"The <guilabel>Format</guilabel> of the playlist can be <guilabel>M3U</" 4109"guilabel>, <guilabel>PLS</guilabel> or <guilabel>XSPF</guilabel>." 4110msgstr "" 4111 4112#. Tag: para 4113#: index.docbook:1616 4114#, no-c-format 4115msgid "" 4116"If <guibutton>Include only the selected files</guibutton> is checked, only " 4117"the selected files will be included in the playlist. If a folder is " 4118"selected, all of its files are selected. If this check box is not activated, " 4119"all audio files are included in the playlist." 4120msgstr "" 4121 4122#. Tag: para 4123#: index.docbook:1622 4124#, no-c-format 4125msgid "" 4126"<guibutton>Sort by file name</guibutton> selects the usual case where the " 4127"files are ordered by file name. With <guibutton>Sort by tag field</" 4128"guibutton>, it is possible to sort by a format string with values from tag " 4129"fields. For instance, \"<userinput>%{track.3}</userinput>\" can be used to " 4130"sort by track number (the \"<userinput>.3</userinput>\" is used to get three " 4131"digits with leading zeros because strings are used for sorting). It is also " 4132"possible to use multiple fields, <abbrev>e.g.</abbrev> \"<userinput>" 4133"%{genre}%{year}</userinput>\" to sort using a string composed of genre and " 4134"year." 4135msgstr "" 4136 4137#. Tag: para 4138#: index.docbook:1632 4139#, no-c-format 4140msgid "" 4141"The playlist entries will have relative or absolute file paths depending on " 4142"whether <guibutton>Use relative path for files in playlist</guibutton> or " 4143"<guibutton>Use full path for files in playlist</guibutton> is set." 4144msgstr "" 4145 4146#. Tag: para 4147#: index.docbook:1637 4148#, no-c-format 4149msgid "" 4150"When <guibutton>Write only list of files</guibutton> is set, the playlist " 4151"will only contain the paths to the files. To generate an extended playlist " 4152"with additional information, a format string can be set using the " 4153"<guibutton>Write info using</guibutton> control." 4154msgstr "" 4155 4156#. Tag: menuchoice 4157#: index.docbook:1647 4158#, no-c-format 4159msgid "" 4160"<shortcut> <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> " 4161"<guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem>" 4162msgstr "" 4163 4164#. Tag: action 4165#: index.docbook:1654 4166#, no-c-format 4167msgid "Quits the application." 4168msgstr "" 4169 4170#. Tag: title 4171#: index.docbook:1663 4172#, no-c-format 4173msgid "The Edit Menu" 4174msgstr "" 4175 4176#. Tag: menuchoice 4177#: index.docbook:1668 4178#, no-c-format 4179msgid "" 4180"<shortcut> <keycombo>&Alt;<keycap>A</keycap></keycombo> </shortcut> " 4181"<guimenu>Edit</guimenu> <guimenuitem>Select All</guimenuitem>" 4182msgstr "" 4183 4184#. Tag: para 4185#: index.docbook:1675 4186#, no-c-format 4187msgid "Selects all files." 4188msgstr "" 4189 4190#. Tag: menuchoice 4191#: index.docbook:1679 4192#, no-c-format 4193msgid "" 4194"<shortcut> <keycombo>&Ctrl;<keycap>Shift</keycap><keycap>A</keycap></" 4195"keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Deselect</" 4196"guimenuitem>" 4197msgstr "" 4198 4199#. Tag: para 4200#: index.docbook:1686 4201#, no-c-format 4202msgid "Deselects all files." 4203msgstr "" 4204 4205#. Tag: menuchoice 4206#: index.docbook:1690 4207#, no-c-format 4208msgid "<guimenu>Edit</guimenu> <guimenuitem>Select All in Folder</guimenuitem>" 4209msgstr "" 4210 4211#. Tag: para 4212#: index.docbook:1694 4213#, no-c-format 4214msgid "Selects all files of the current folder." 4215msgstr "" 4216 4217#. Tag: menuchoice 4218#: index.docbook:1698 4219#, no-c-format 4220msgid "" 4221"<shortcut> <keycombo>&Alt;<keycap>Up</keycap></keycombo> </shortcut> " 4222"<guimenu>Edit</guimenu> <guimenuitem>Previous File</guimenuitem>" 4223msgstr "" 4224 4225#. Tag: para 4226#: index.docbook:1705 4227#, no-c-format 4228msgid "Selects the previous file." 4229msgstr "" 4230 4231#. Tag: menuchoice 4232#: index.docbook:1709 4233#, no-c-format 4234msgid "" 4235"<shortcut> <keycombo>&Alt;<keycap>Down</keycap></keycombo> </shortcut> " 4236"<guimenu>Edit</guimenu> <guimenuitem>Next File</guimenuitem>" 4237msgstr "" 4238 4239#. Tag: para 4240#: index.docbook:1716 4241#, no-c-format 4242msgid "Selects the next file." 4243msgstr "" 4244 4245#. Tag: menuchoice 4246#: index.docbook:1720 4247#, no-c-format 4248msgid "" 4249"<shortcut> <keycombo>&Ctrl;<keycap>F</keycap></keycombo> </shortcut> " 4250"<guimenu>Edit</guimenu> <guimenuitem>Find...</guimenuitem>" 4251msgstr "" 4252 4253#. Tag: para 4254#: index.docbook:1727 4255#, no-c-format 4256msgid "" 4257"Find strings in the file names and the tags. The <guilabel>Find</guilabel> " 4258"dialog is a subset of the <guilabel>Replace</guilabel> dialog, which is " 4259"described below." 4260msgstr "" 4261 4262#. Tag: menuchoice 4263#: index.docbook:1734 4264#, no-c-format 4265msgid "" 4266"<shortcut> <keycombo>&Ctrl;<keycap>R</keycap></keycombo> </shortcut> " 4267"<guimenu>Edit</guimenu> <guimenuitem>Replace...</guimenuitem>" 4268msgstr "" 4269 4270#. Tag: para 4271#: index.docbook:1741 4272#, no-c-format 4273msgid "" 4274"This function opens a dialog to find and replace strings in the file names " 4275"and the tags. The set of frames where the search is performed can be " 4276"restricted by deactivating the <guilabel>Select all</guilabel> check box and " 4277"selecting the frames which shall be searched. There are also search options " 4278"available to search backwards, case sensitively, and to use regular " 4279"expressions." 4280msgstr "" 4281 4282#. Tag: para 4283#: index.docbook:1747 4284#, no-c-format 4285msgid "" 4286"Depending on the number of files, the search might take some time, therefore " 4287"it can be aborted by closing the dialog." 4288msgstr "" 4289 4290#. Tag: title 4291#: index.docbook:1756 4292#, no-c-format 4293msgid "The Tools Menu" 4294msgstr "" 4295 4296#. Tag: menuchoice 4297#: index.docbook:1761 4298#, no-c-format 4299msgid "" 4300"<guimenu>Tools</guimenu> <guimenuitem>Apply Filename Format</guimenuitem>" 4301msgstr "" 4302 4303#. Tag: para 4304#: index.docbook:1765 4305#, no-c-format 4306msgid "" 4307"When <guilabel>Automatically apply format</guilabel> is switched off for the " 4308"filename format in the configuration dialog, this menu item can be used to " 4309"<action>apply the configured format to the names of the selected files</" 4310"action>. This can also be used to check whether the file names conform with " 4311"the configured format by applying the format to all saved files and then " 4312"checking if any files were changed (and therefore marked with a disk symbol " 4313"in the file listbox)." 4314msgstr "" 4315 4316#. Tag: menuchoice 4317#: index.docbook:1775 4318#, no-c-format 4319msgid "<guimenu>Tools</guimenu> <guimenuitem>Apply Tag Format</guimenuitem>" 4320msgstr "" 4321 4322#. Tag: para 4323#: index.docbook:1779 4324#, no-c-format 4325msgid "" 4326"When <guilabel>Automatically apply format</guilabel> is switched off for the " 4327"tag format in the configuration dialog, this menu item can be used to " 4328"<action>apply the configured format to the tags of the selected files</" 4329"action>. This can also be used to check whether the tags conform with the " 4330"configured format by applying the format to all saved files and then " 4331"checking if any files were changed (and therefore marked with a disk symbol " 4332"in the file listbox)." 4333msgstr "" 4334 4335#. Tag: menuchoice 4336#: index.docbook:1789 4337#, no-c-format 4338msgid "<guimenu>Tools</guimenu> <guimenuitem>Apply Text Encoding</guimenuitem>" 4339msgstr "" 4340 4341#. Tag: para 4342#: index.docbook:1793 4343#, no-c-format 4344msgid "" 4345"Sets the <guilabel>Text encoding</guilabel> selected in " 4346"<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kid3;... </" 4347"guimenuitem><guimenuitem>Tags section</guimenuitem><guimenuitem>Tag 2 tab</" 4348"guimenuitem></menuchoice> for all selected files. If UTF8 is selected, UTF16 " 4349"will be used for ID3v2.3.0 tags because UTF8 is not supported for this " 4350"format." 4351msgstr "" 4352 4353#. Tag: menuchoice 4354#: index.docbook:1802 4355#, no-c-format 4356msgid "<guimenu>Tools</guimenu> <guimenuitem>Rename Folder...</guimenuitem>" 4357msgstr "" 4358 4359#. Tag: para 4360#: index.docbook:1806 4361#, no-c-format 4362msgid "" 4363"This dialog offers the possibility to automatically rename the currently " 4364"open folder according to the tags in the files. Several formats are " 4365"preconfigured to include information about artist, album and year in the " 4366"folder name. It is also possible to set a custom format and <guibutton>Edit</" 4367"guibutton> the list of available formats. The following special codes are " 4368"used to insert tag values into the folder name:" 4369msgstr "" 4370 4371#. Tag: para 4372#: index.docbook:1824 4373#, no-c-format 4374msgid "" 4375"%{dirname} Folder name (<abbrev>e.g.</abbrev> %{year\" \"}%{dirname} will " 4376"prepend the year to the current folder name)" 4377msgstr "" 4378 4379#. Tag: para 4380#: index.docbook:1826 4381#, no-c-format 4382msgid "" 4383"%{max-year} The maximum year value found for this folder, can also be used " 4384"with other codes than \"year\"" 4385msgstr "" 4386 4387#. Tag: para 4388#: index.docbook:1828 4389#, no-c-format 4390msgid "%{min-year} The minimum year value found for this folder" 4391msgstr "" 4392 4393#. Tag: para 4394#: index.docbook:1830 4395#, no-c-format 4396msgid "" 4397"%{unq-year} The unique year value found for this folder or empty if not " 4398"unique" 4399msgstr "" 4400 4401#. Tag: para 4402#: index.docbook:1834 4403#, no-c-format 4404msgid "" 4405"If a folder separator \"/\" is found in the format, multiple folders are " 4406"created. If you want to create a new folder instead of renaming the current " 4407"folder, in the <guilabel>Action</guilabel> combo box select <guilabel>Create " 4408"Folder</guilabel> instead of <guilabel>Rename Folder</guilabel>. The " 4409"<guilabel>Source</guilabel> of the tag information can be chosen between " 4410"<guilabel>Tag 1 and Tag 2</guilabel>, <guilabel>Tag 1</guilabel> and " 4411"<guilabel>Tag 2</guilabel>. A preview for the rename operation performed on " 4412"the first file can be seen in the <guilabel>From</guilabel> and " 4413"<guilabel>To</guilabel> sections of the dialog." 4414msgstr "" 4415 4416#. Tag: para 4417#: index.docbook:1845 4418#, no-c-format 4419msgid "Multiple folders can be renamed by selecting them." 4420msgstr "" 4421 4422#. Tag: menuchoice 4423#: index.docbook:1851 4424#, no-c-format 4425msgid "<guimenu>Tools</guimenu> <guimenuitem>Number Tracks...</guimenuitem>" 4426msgstr "" 4427 4428#. Tag: para 4429#: index.docbook:1855 4430#, no-c-format 4431msgid "" 4432"If the track numbers in the tags are not set or have the wrong values, this " 4433"function can <action>number the tracks automatically in ascending order</" 4434"action>. The start number can be set in the dialog. If only part of the " 4435"tracks have to be numbered, they must be selected." 4436msgstr "" 4437 4438#. Tag: para 4439#: index.docbook:1860 4440#, no-c-format 4441msgid "" 4442"When <guilabel>Total number of tracks</guilabel> is checked, the number of " 4443"tracks will also be set in the tags." 4444msgstr "" 4445 4446#. Tag: para 4447#: index.docbook:1863 4448#, no-c-format 4449msgid "" 4450"It is possible to number the tracks over multiple folders. The folders have " 4451"to be expanded and selected." 4452msgstr "" 4453 4454#. Tag: para 4455#: index.docbook:1866 4456#, no-c-format 4457msgid "" 4458"If <guilabel>Reset counter for each folder</guilabel> is checked, track " 4459"numbering is restarted with the given number for each folder when multiple " 4460"folders are selected." 4461msgstr "" 4462 4463#. Tag: para 4464#: index.docbook:1870 4465#, no-c-format 4466msgid "" 4467"The number tracks dialog can also be used to format existing track numbers " 4468"without changing the values when the check box left to <guilabel>Start " 4469"number</guilabel> is deactivated. The total number of tracks will be added " 4470"if the corresponding check box is active, which can be used to set the total " 4471"for all selected tracks. If only formatting of the existing numbers is " 4472"desired, this check box has to be deactivated too." 4473msgstr "" 4474 4475#. Tag: menuchoice 4476#: index.docbook:1881 4477#, no-c-format 4478msgid "<guimenu>Tools</guimenu> <guimenuitem>Filter...</guimenuitem>" 4479msgstr "" 4480 4481#. Tag: para 4482#: index.docbook:1886 4483#, no-c-format 4484msgid "" 4485"The filter can be used to display only those files which match certain " 4486"criteria. This is helpful if you want to organize a large collection and " 4487"only edit those files which are not in the desired scheme. The expression " 4488"defining which files to display uses the same format codes which are used in " 4489"the file name format, import and export." 4490msgstr "" 4491 4492#. Tag: para 4493#: index.docbook:1905 4494#, no-c-format 4495msgid "%p %{filepath} Absolute path to file" 4496msgstr "" 4497 4498#. Tag: para 4499#: index.docbook:1919 4500#, no-c-format 4501msgid "" 4502"%w %{marked} Marked, is 1 if the file is marked (<abbrev>e.g.</abbrev> " 4503"because of truncation or standard violation), empty otherwise" 4504msgstr "" 4505 4506#. Tag: para 4507#: index.docbook:1921 4508#, no-c-format 4509msgid "%1a %1{artist}, ... Use the prefix 1 to get values of tag 1" 4510msgstr "" 4511 4512#. Tag: para 4513#: index.docbook:1922 4514#, no-c-format 4515msgid "%2a %2{artist}, ... Use the prefix 2 to get values of tag 2" 4516msgstr "" 4517 4518#. Tag: para 4519#: index.docbook:1925 4520#, no-c-format 4521msgid "" 4522"These codes are replaced with the values for the file, and the resulting " 4523"strings can be compared with the following operations:" 4524msgstr "" 4525 4526#. Tag: para 4527#: index.docbook:1931 4528#, no-c-format 4529msgid "s1 equals s2: true if s1 and s2 are equal." 4530msgstr "" 4531 4532#. Tag: para 4533#: index.docbook:1932 4534#, no-c-format 4535msgid "" 4536"s1 contains s2: true if s1 contains s2, <abbrev>i.e.</abbrev> s2 is a " 4537"substring of s1." 4538msgstr "" 4539 4540#. Tag: para 4541#: index.docbook:1934 4542#, no-c-format 4543msgid "s matches re: true if s matches the regular expression re." 4544msgstr "" 4545 4546#. Tag: para 4547#: index.docbook:1936 4548#, no-c-format 4549msgid "" 4550"True expressions are replaced by 1, false by 0. True values are represented " 4551"by 1, true, on and yes, false values by 0, false, off and no. Boolean " 4552"operations are not, and, or (in this order of precedence) and can be grouped " 4553"by parentheses." 4554msgstr "" 4555 4556#. Tag: para 4557#: index.docbook:1941 4558#, no-c-format 4559msgid "" 4560"Some filter rules are predefined and can serve as examples for your own " 4561"expressions:" 4562msgstr "" 4563 4564#. Tag: term 4565#: index.docbook:1947 4566#, no-c-format 4567msgid "<term>All</term>" 4568msgstr "" 4569 4570#. Tag: para 4571#: index.docbook:1948 4572#, no-c-format 4573msgid "" 4574"When the file list is filtered - this is shown by \"[filtered]\" in the " 4575"window title - and all files shall be displayed again, the filtering can be " 4576"reverted using this filter. It uses an empty expression, but a true value " 4577"would have the same effect." 4578msgstr "" 4579 4580#. Tag: term 4581#: index.docbook:1956 4582#, no-c-format 4583msgid "Filename Tag Mismatch" 4584msgstr "" 4585 4586#. Tag: userinput 4587#: index.docbook:1957 4588#, no-c-format 4589msgid "not (%{filepath} contains \"%{artist} - %{album}/%{track} %{title}\")" 4590msgstr "" 4591 4592#. Tag: para 4593#: index.docbook:1960 4594#, no-c-format 4595msgid "" 4596"Tests if the file path conforms with the file name format. This rule is " 4597"automatically adapted if the file name format changes." 4598msgstr "" 4599 4600#. Tag: term 4601#: index.docbook:1966 4602#, no-c-format 4603msgid "No Tag 1" 4604msgstr "" 4605 4606#. Tag: userinput 4607#: index.docbook:1967 4608#, no-c-format 4609msgid "%{tag1} equals \"\"" 4610msgstr "" 4611 4612#. Tag: para 4613#: index.docbook:1970 4614#, no-c-format 4615msgid "Displays only files which do not have a tag 1." 4616msgstr "" 4617 4618#. Tag: term 4619#: index.docbook:1973 4620#, no-c-format 4621msgid "No Tag 2" 4622msgstr "" 4623 4624#. Tag: userinput 4625#: index.docbook:1974 4626#, no-c-format 4627msgid "%{tag2} equals \"\"" 4628msgstr "" 4629 4630#. Tag: para 4631#: index.docbook:1977 4632#, no-c-format 4633msgid "Displays only files which do not have a tag 2." 4634msgstr "" 4635 4636#. Tag: term 4637#: index.docbook:1980 4638#, no-c-format 4639msgid "ID3v2.3.0 Tag" 4640msgstr "" 4641 4642#. Tag: userinput 4643#: index.docbook:1981 4644#, no-c-format 4645msgid "%{tag2} equals \"ID3v2.3.0\"" 4646msgstr "" 4647 4648#. Tag: para 4649#: index.docbook:1984 4650#, no-c-format 4651msgid "Displays only files which have an ID3v2.3.0 tag." 4652msgstr "" 4653 4654#. Tag: term 4655#: index.docbook:1987 4656#, no-c-format 4657msgid "ID3v2.4.0 Tag" 4658msgstr "" 4659 4660#. Tag: userinput 4661#: index.docbook:1988 4662#, no-c-format 4663msgid "%{tag2} equals \"ID3v2.4.0\"" 4664msgstr "" 4665 4666#. Tag: para 4667#: index.docbook:1991 4668#, no-c-format 4669msgid "Displays only files which have an ID3v2.4.0 tag." 4670msgstr "" 4671 4672#. Tag: term 4673#: index.docbook:1994 4674#, no-c-format 4675msgid "Tag 1 != Tag 2" 4676msgstr "" 4677 4678#. Tag: userinput 4679#: index.docbook:1995 4680#, no-c-format 4681msgid "" 4682"not (%1{title} equals %2{title} and %1{album} equals %2{album} and " 4683"%1{artist} equals %2{artist} and %1{comment} equals %2{comment} and %1{year} " 4684"equals %2{year} and %1{track} equals %2{track} and %1{genre} equals " 4685"%2{genre})" 4686msgstr "" 4687 4688#. Tag: para 4689#: index.docbook:2000 4690#, no-c-format 4691msgid "Displays files with differences between tag 1 and tag2." 4692msgstr "" 4693 4694#. Tag: term 4695#: index.docbook:2003 4696#, no-c-format 4697msgid "Tag 1 == Tag 2" 4698msgstr "" 4699 4700#. Tag: userinput 4701#: index.docbook:2004 4702#, no-c-format 4703msgid "" 4704"%1{title} equals %2{title} and %1{album} equals %2{album} and %1{artist} " 4705"equals %2{artist} and %1{comment} equals %2{comment} and %1{year} equals " 4706"%2{year} and %1{track} equals %2{track} and %1{genre} equals %2{genre}" 4707msgstr "" 4708 4709#. Tag: para 4710#: index.docbook:2009 4711#, no-c-format 4712msgid "Displays files with identical tag 1 and tag 2." 4713msgstr "" 4714 4715#. Tag: term 4716#: index.docbook:2012 4717#, no-c-format 4718msgid "Incomplete" 4719msgstr "" 4720 4721#. Tag: userinput 4722#: index.docbook:2013 4723#, no-c-format 4724msgid "" 4725"%{title} equals \"\" or %{artist} equals \"\" or %{album} equals \"\" or " 4726"%{year} equals \"\" or %{tracknumber} equals \"\" or %{genre} equals \"\"" 4727msgstr "" 4728 4729#. Tag: para 4730#: index.docbook:2016 4731#, no-c-format 4732msgid "" 4733"Displays files with empty values in the standard tags (title, artist, album, " 4734"date, track number, genre)." 4735msgstr "" 4736 4737#. Tag: term 4738#: index.docbook:2020 4739#, no-c-format 4740msgid "No Picture" 4741msgstr "" 4742 4743#. Tag: userinput 4744#: index.docbook:2021 4745#, no-c-format 4746msgid "%{picture} equals \"\"" 4747msgstr "" 4748 4749#. Tag: para 4750#: index.docbook:2024 4751#, no-c-format 4752msgid "Displays only files which do not have a picture." 4753msgstr "" 4754 4755#. Tag: term 4756#: index.docbook:2027 4757#, no-c-format 4758msgid "Marked" 4759msgstr "" 4760 4761#. Tag: userinput 4762#: index.docbook:2028 4763#, no-c-format 4764msgid "not (%{marked} equals \"\")" 4765msgstr "" 4766 4767#. Tag: para 4768#: index.docbook:2031 4769#, no-c-format 4770msgid "" 4771"Displays only files which are marked because they violate the ID3 standard, " 4772"are truncated or the picture is too large." 4773msgstr "" 4774 4775#. Tag: term 4776#: index.docbook:2035 4777#, no-c-format 4778msgid "Custom Filter" 4779msgstr "" 4780 4781#. Tag: para 4782#: index.docbook:2036 4783#, no-c-format 4784msgid "" 4785"To add your own filter, select this entry. For instance, if you want to have " 4786"a filter for artists starting with \"The\", replace \"Custom Filter\" with " 4787"the name \"The Bands\" and press <keycap>Enter</keycap>. Then insert the " 4788"following expression into the line edit:" 4789msgstr "" 4790 4791#. Tag: userinput 4792#: index.docbook:2042 4793#, no-c-format 4794msgid "%{artist} matches \"The.*\"" 4795msgstr "" 4796 4797#. Tag: para 4798#: index.docbook:2045 4799#, no-c-format 4800msgid "" 4801"Then click <guibutton>Save Settings</guibutton>. Click <guibutton>Apply</" 4802"guibutton> to filter the files. All files processed are displayed in the " 4803"text view, with a \"+\" for those who match the filter and a \"-\" for the " 4804"others. When finished, only the files with an artist starting with \"The\" " 4805"are displayed, and the window title is marked with \"[filtered]\"." 4806msgstr "" 4807 4808#. Tag: menuchoice 4809#: index.docbook:2060 4810#, no-c-format 4811msgid "" 4812"<guimenu>Tools</guimenu> <guimenuitem>Convert ID3v2.3 to ID3v2.4</" 4813"guimenuitem>" 4814msgstr "" 4815 4816#. Tag: para 4817#: index.docbook:2064 4818#, no-c-format 4819msgid "" 4820"If there are any ID3v2.3 tags in the selected files, they will be " 4821"<action>converted to ID3v2.4</action> tags. Frames which are not supported " 4822"by TagLib will be discarded. Only files without unsaved changes will be " 4823"converted." 4824msgstr "" 4825 4826#. Tag: menuchoice 4827#: index.docbook:2072 4828#, no-c-format 4829msgid "" 4830"<guimenu>Tools</guimenu> <guimenuitem>Convert ID3v2.4 to ID3v2.3</" 4831"guimenuitem>" 4832msgstr "" 4833 4834#. Tag: para 4835#: index.docbook:2076 4836#, no-c-format 4837msgid "" 4838"If there are any ID3v2.4 tags in the selected files, they will be " 4839"<action>converted to ID3v2.3</action> tags. Only files without unsaved " 4840"changes will be converted." 4841msgstr "" 4842 4843#. Tag: menuchoice 4844#: index.docbook:2084 4845#, no-c-format 4846msgid "<guimenu>Tools</guimenu> <guimenuitem>Play</guimenuitem>" 4847msgstr "" 4848 4849#. Tag: para 4850#: index.docbook:2088 4851#, no-c-format 4852msgid "" 4853"This opens a simple toolbar to play audio files. It contains buttons for the " 4854"basic operations (<guibutton>Play/Pause</guibutton>, <guibutton>Stop " 4855"playback</guibutton>, <guibutton>Previous Track</guibutton>, <guibutton>Next " 4856"Track</guibutton>, <guibutton>Close</guibutton>), sliders for position and " 4857"volume and a display of the current position. If multiple files are " 4858"selected, the selected tracks are played, else all files will be played." 4859msgstr "" 4860 4861#. Tag: title 4862#: index.docbook:2104 4863#, no-c-format 4864msgid "The Settings Menu" 4865msgstr "" 4866 4867#. Tag: menuchoice 4868#: index.docbook:2109 4869#, no-c-format 4870msgid "<guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem>" 4871msgstr "" 4872 4873#. Tag: action 4874#: index.docbook:2113 4875#, no-c-format 4876msgid "Toggles displaying of the toolbar." 4877msgstr "" 4878 4879#. Tag: menuchoice 4880#: index.docbook:2117 4881#, no-c-format 4882msgid "<guimenu>Settings</guimenu> <guimenuitem>Show Statusbar</guimenuitem>" 4883msgstr "" 4884 4885#. Tag: para 4886#: index.docbook:2121 4887#, no-c-format 4888msgid "" 4889"<action>Toggles displaying of the statusbar</action>, which displays longer " 4890"actions such as opening or saving a folder." 4891msgstr "" 4892 4893#. Tag: menuchoice 4894#: index.docbook:2126 4895#, no-c-format 4896msgid "<guimenu>Settings</guimenu> <guimenuitem>Show Picture</guimenuitem>" 4897msgstr "" 4898 4899#. Tag: action 4900#: index.docbook:2130 4901#, no-c-format 4902msgid "Toggles displaying of the album cover art preview picture." 4903msgstr "" 4904 4905#. Tag: menuchoice 4906#: index.docbook:2136 4907#, no-c-format 4908msgid "<guimenu>Settings</guimenu> <guimenuitem>Auto Hide Tags</guimenuitem>" 4909msgstr "" 4910 4911#. Tag: para 4912#: index.docbook:2140 4913#, no-c-format 4914msgid "" 4915"Empty tags are automatically hidden if this option is active. The " 4916"<guilabel>File</guilabel>, <guilabel>Tag 1</guilabel> and <guilabel>Tag 2</" 4917"guilabel> sections can be manually collapsed and expanded by clicking on the " 4918"corresponding <guibutton>-</guibutton>/<guibutton>+</guibutton> buttons." 4919msgstr "" 4920 4921#. Tag: menuchoice 4922#: index.docbook:2150 4923#, no-c-format 4924msgid "" 4925"<guimenu>Settings</guimenu> <guimenuitem>Configure Shortcut keys...</" 4926"guimenuitem>" 4927msgstr "" 4928 4929#. Tag: para 4930#: index.docbook:2154 4931#, no-c-format 4932msgid "" 4933"Opens a dialog to assign keyboard shortcuts for most of the program " 4934"functions. There are even functions without corresponding menu or button " 4935"available, <abbrev>e.g.</abbrev> next file, previous file, select all." 4936msgstr "" 4937 4938#. Tag: menuchoice 4939#: index.docbook:2164 4940#, no-c-format 4941msgid "" 4942"<guimenu>Settings</guimenu> <guimenuitem>Configure &kid3;...</guimenuitem>" 4943msgstr "" 4944 4945#. Tag: para 4946#: index.docbook:2168 4947#, no-c-format 4948msgid "" 4949"Opens the <action>configuration dialog</action>, which consists of pages for " 4950"tags, files, user actions, and network settings." 4951msgstr "" 4952 4953#. Tag: para 4954#: index.docbook:2171 4955#, no-c-format 4956msgid "" 4957"Tag specific options can be found on the <guilabel>Tags</guilabel> page, " 4958"which is itself separated into four tabs for <guilabel>Tag 1</guilabel>, " 4959"<guilabel>Tag 2</guilabel>, <guilabel>Tag 3</guilabel>, and <guilabel>All " 4960"Tags</guilabel>." 4961msgstr "" 4962 4963#. Tag: para 4964#: index.docbook:2177 4965#, no-c-format 4966msgid "" 4967"If <guilabel>Mark truncated fields</guilabel> is checked, truncated ID3v1.1 " 4968"fields will be marked red. The text fields of ID3v1.1 tags can only have 30 " 4969"characters, the comment only 28 characters. Also the genre and track numbers " 4970"are restricted, so that fields can be truncated when imported or transferred " 4971"from ID3v2. Truncated fields and the file will be marked red, and the mark " 4972"will be removed after the field has been edited." 4973msgstr "" 4974 4975#. Tag: para 4976#: index.docbook:2185 4977#, no-c-format 4978msgid "" 4979"With <guilabel>Text encoding</guilabel> for <guilabel>ID3v1</guilabel> it is " 4980"possible to set the character set used in ID3v1 tags. This encoding is " 4981"supposed to be ISO-8859-1, so it is recommended to keep this default value. " 4982"However, there are tags around with different encoding, so it can be set " 4983"here and the ID3v1 tags can then be copied to ID3v2 which supports Unicode." 4984msgstr "" 4985 4986#. Tag: para 4987#: index.docbook:2192 4988#, no-c-format 4989msgid "" 4990"The check box <guilabel>Use track/total number of tracks format</guilabel> " 4991"controls whether the track number field of ID3v2 tags contains simply the " 4992"track number or additionally the total number of tracks in the folder." 4993msgstr "" 4994 4995#. Tag: para 4996#: index.docbook:2198 4997#, no-c-format 4998msgid "" 4999"When <guilabel>Genre as text instead of numeric string</guilabel> is " 5000"checked, all ID3v2 genres will be stored as a text string even if there is a " 5001"corresponding code for ID3v1 genres. If this option is not set, genres for " 5002"which an ID3v1 code exists are stored as the number of the genre code (in " 5003"parentheses for ID3v2.3). Thus the genre Metal is stored as \"Metal\" or " 5004"\"(9)\" depending on this option. Genres which are not in the list of ID3v1 " 5005"genres are always stored as a text string. The purpose of this option is " 5006"improved compatibility with devices which do not correctly interpret genre " 5007"codes." 5008msgstr "" 5009 5010#. Tag: para 5011#: index.docbook:2208 5012#, no-c-format 5013msgid "" 5014"When <guilabel>WAV files with lowercase id3 chunk</guilabel> is checked, the " 5015"RIFF chunk used to store ID3v2 tags in WAV files will be named \"id3 \" " 5016"instead of \"ID3 \". By default, &kid3; and other applications using TagLib " 5017"accept both the lowercase and the uppercase variant when reading WAV files, " 5018"but they use \"ID3 \" when writing ID3v2 tags to WAV files. As there exist " 5019"other applications which only accept \"id3 \" (<abbrev>e.g.</abbrev> JRiver " 5020"Media Center and foobar2000), this option can be used to create tags which " 5021"can be read by such applications." 5022msgstr "" 5023 5024#. Tag: para 5025#: index.docbook:2217 5026#, no-c-format 5027msgid "" 5028"When <guilabel>Mark standard violations</guilabel> is checked, ID3v2 fields " 5029"which violate the standard will be marked red. Details about the violation " 5030"are shown in a tooltip:" 5031msgstr "" 5032 5033#. Tag: para 5034#: index.docbook:2223 5035#, no-c-format 5036msgid "Must be unique" 5037msgstr "" 5038 5039#. Tag: para 5040#: index.docbook:2224 5041#, no-c-format 5042msgid "New line is forbidden" 5043msgstr "" 5044 5045#. Tag: para 5046#: index.docbook:2225 5047#, no-c-format 5048msgid "Carriage return is forbidden" 5049msgstr "" 5050 5051#. Tag: para 5052#: index.docbook:2226 5053#, no-c-format 5054msgid "Owner must be non-empty" 5055msgstr "" 5056 5057#. Tag: para 5058#: index.docbook:2227 5059#, no-c-format 5060msgid "Must be numeric" 5061msgstr "" 5062 5063#. Tag: para 5064#: index.docbook:2228 5065#, no-c-format 5066msgid "Must be numeric or number/total" 5067msgstr "" 5068 5069#. Tag: para 5070#: index.docbook:2229 5071#, no-c-format 5072msgid "Format is DDMM" 5073msgstr "" 5074 5075#. Tag: para 5076#: index.docbook:2230 5077#, no-c-format 5078msgid "Format is HHMM" 5079msgstr "" 5080 5081#. Tag: para 5082#: index.docbook:2231 5083#, no-c-format 5084msgid "Format is YYYY" 5085msgstr "" 5086 5087#. Tag: para 5088#: index.docbook:2232 5089#, no-c-format 5090msgid "Must begin with a year and a space character" 5091msgstr "" 5092 5093#. Tag: para 5094#: index.docbook:2233 5095#, no-c-format 5096msgid "Must be ISO 8601 date/time" 5097msgstr "" 5098 5099#. Tag: para 5100#: index.docbook:2234 5101#, no-c-format 5102msgid "Must be musical key, 3 characters, A-G, b, #, m, o" 5103msgstr "" 5104 5105#. Tag: para 5106#: index.docbook:2235 5107#, no-c-format 5108msgid "Must have ISO 639-2 language code, 3 lowercase characters" 5109msgstr "" 5110 5111#. Tag: para 5112#: index.docbook:2236 5113#, no-c-format 5114msgid "Must be ISRC code, 12 characters" 5115msgstr "" 5116 5117#. Tag: para 5118#: index.docbook:2237 5119#, no-c-format 5120msgid "Must be list of strings separated by '|'" 5121msgstr "" 5122 5123#. Tag: para 5124#: index.docbook:2238 5125#, no-c-format 5126msgid "Has excess white space" 5127msgstr "" 5128 5129#. Tag: para 5130#: index.docbook:2240 5131#, no-c-format 5132msgid "The ID3 standard documents are available online:" 5133msgstr "" 5134 5135#. Tag: ulink 5136#: index.docbook:2244 5137#, no-c-format 5138msgid "ID3 tag version 2.3.0" 5139msgstr "" 5140 5141#. Tag: ulink 5142#: index.docbook:2245 5143#, no-c-format 5144msgid "ID3 tag version 2.4.0 - Main Structure" 5145msgstr "" 5146 5147#. Tag: ulink 5148#: index.docbook:2246 5149#, no-c-format 5150msgid "ID3 tag version 2.4.0 - Native Frames" 5151msgstr "" 5152 5153#. Tag: para 5154#: index.docbook:2248 5155#, no-c-format 5156msgid "" 5157"<guilabel>Text encoding</guilabel> defines the default encoding used for " 5158"ID3v2 frames and can be set to <guilabel>ISO-8859-1</guilabel>, " 5159"<guilabel>UTF16</guilabel>, or <guilabel>UTF8</guilabel>. <guilabel>UTF8</" 5160"guilabel> is not valid for ID3v2.3.0 frames; if it is set, <guilabel>UTF16</" 5161"guilabel> will be used instead. For ID3v2.4.0 frames, all three encodings " 5162"are possible." 5163msgstr "" 5164 5165#. Tag: para 5166#: index.docbook:2256 5167#, no-c-format 5168msgid "" 5169"<guilabel>Version used for new tags</guilabel> determines whether new ID3v2 " 5170"tags are created as version 2.3.0 or 2.4.0." 5171msgstr "" 5172 5173#. Tag: para 5174#: index.docbook:2260 5175#, no-c-format 5176msgid "" 5177"<guilabel>Track number digits</guilabel> is the number of digits in Track " 5178"Number fields. Leading zeros are used to pad. For instance, with a value of " 5179"2 the track number 5 is set as \"05\"." 5180msgstr "" 5181 5182#. Tag: para 5183#: index.docbook:2265 5184#, no-c-format 5185msgid "" 5186"The combo box <guilabel>Comment field name</guilabel> is only relevant for " 5187"Ogg/Vorbis and FLAC files and sets the name of the field used for comments. " 5188"Different applications seem to use different names, \"<literal>COMMENT</" 5189"literal>\" for instance is used by <application>XMMS</application>, whereas " 5190"&amarok; uses \"<literal>DESCRIPTION</literal>\"." 5191msgstr "" 5192 5193#. Tag: para 5194#: index.docbook:2272 5195#, no-c-format 5196msgid "" 5197"The format of pictures in Ogg/Vorbis files is determined by " 5198"<guilabel>Picture field name</guilabel>, which can be " 5199"\"<literal>METADATA_BLOCK_PICTURE</literal>\" or \"<literal>COVERART</" 5200"literal>\". The first is the official standard and uses the same format as " 5201"pictures in FLAC tags. \"<literal>COVERART</literal>\" is an earlier " 5202"unofficial way to include pictures in Vorbis comments. It can be used for " 5203"compatibility with legacy players." 5204msgstr "" 5205 5206#. Tag: para 5207#: index.docbook:2280 5208#, no-c-format 5209msgid "" 5210"If the <guilabel>Mark if larger than (bytes)</guilabel> check box is " 5211"activated, files containing embedded album cover art exceeding the given " 5212"size in bytes are marked red. This can be used to find files containing " 5213"oversized pictures which are not accepted by some applications and players. " 5214"The default value is 131072 bytes (128 KB)." 5215msgstr "" 5216 5217#. Tag: para 5218#: index.docbook:2287 5219#, no-c-format 5220msgid "" 5221"<guilabel>Custom Genres</guilabel> can be used to define genres which are " 5222"not available in the standard genre list, <abbrev>e.g.</abbrev> \"Gothic " 5223"Metal\". Such custom genres will appear in the <guilabel>Genre</guilabel> " 5224"combo box of <guilabel>Tag 2</guilabel>. For ID3v1.1 tags, only the " 5225"predefined genres can be used." 5226msgstr "" 5227 5228#. Tag: para 5229#: index.docbook:2294 5230#, no-c-format 5231msgid "" 5232"The list of custom genres can also be used to reduce the number of genres " 5233"available in the <guilabel>Genre</guilabel> combo box to those typically " 5234"used. If your collection mostly contains music in the genres Metal, Gothic " 5235"Metal, Ancient and Hard Rock, you can enter those genres and mark " 5236"<guilabel>Show only custom genres</guilabel>. The <guilabel>Tag 2</guilabel> " 5237"<guilabel>Genre</guilabel> combo box will then only contain those four " 5238"genres and you will not have to search through the complete genres list for " 5239"them. In this example, only Metal and Hard Rock will be listed in the tag 1 " 5240"genres list, because those two custom genres entries are standard genres. If " 5241"<guilabel>Show only custom genres</guilabel> is not active, the custom " 5242"genres can be found at the end of the genres list." 5243msgstr "" 5244 5245#. Tag: para 5246#: index.docbook:2307 5247#, no-c-format 5248msgid "" 5249"<guilabel>Quick Access Frames</guilabel> defines which frame types are " 5250"always shown in the <link linkend=\"tag2\">Tag 2</link> section. Such frames " 5251"can then be added without first using the <guibutton>Add</guibutton> button. " 5252"The order of these quick access frames can be changed by dragging and " 5253"dropping items." 5254msgstr "" 5255 5256#. Tag: para 5257#: index.docbook:2314 5258#, no-c-format 5259msgid "" 5260"The combo box <guilabel>Track number field name</guilabel> is only relevant " 5261"for RIFF INFO and sets the name of the field used for track numbers. Track " 5262"numbers are not specified in the original RIFF standard, there are " 5263"applications which use \"<literal>ITRK</literal>\", others use " 5264"\"<literal>IPRT</literal>\"." 5265msgstr "" 5266 5267#. Tag: para 5268#: index.docbook:2321 5269#, no-c-format 5270msgid "" 5271"<guilabel>Tag Format</guilabel> contains options for the format of the tags. " 5272"When <guilabel>Automatically apply format</guilabel> is checked, the format " 5273"configuration is automatically used while editing text in the line edits. " 5274"<guilabel>Validation</guilabel> enables validators in the controls with " 5275"track/total and date/time values. The <guilabel>Case conversion</guilabel> " 5276"can be set to <guilabel>No changes</guilabel>, <guilabel>All lowercase</" 5277"guilabel>, <guilabel>All uppercase</guilabel>, <guilabel>First letter " 5278"uppercase</guilabel> or <guilabel>All first letters uppercase</guilabel>. To " 5279"use locale-aware conversion between lowercase and uppercase characters, a " 5280"locale can be selected in the combobox below. The string replacement list " 5281"can be set to arbitrary string mappings. To add a new mapping, select the " 5282"<guilabel>From</guilabel> cell of a row and insert the text to replace, then " 5283"go to the <guilabel>To</guilabel> column and enter the replacement text. " 5284"When the text to replace starts and ends with a slash (\"/\"), a regular " 5285"expression is used. For regular expressions containing capturing groups, " 5286"occurrences of \\1, \\2, ... in <guilabel>To</guilabel> are replaced with " 5287"the string captured by the corresponding capturing group. To remove a " 5288"mapping set the <guilabel>From</guilabel> cell to an empty value (<abbrev>e." 5289"g.</abbrev> by first typing space and then backspace). Inserting and " 5290"deleting rows is also possible using a context menu which appears when the " 5291"<mousebutton>right</mousebutton> mouse button is clicked. Replacement is " 5292"only active, if the <guilabel>String replacement</guilabel> check box is " 5293"checked." 5294msgstr "" 5295 5296#. Tag: para 5297#: index.docbook:2347 5298#, no-c-format 5299msgid "" 5300"The table in <guilabel>Rating</guilabel> contains the mapping of star " 5301"ratings to the effective values stored in the tag. The frames with rating " 5302"information are listed in the Rating row of the <link linkend=\"table-frame-" 5303"list\">frame list</link>. For these frames, the rating can be set by giving " 5304"a number of stars out of five stars. Different tag formats and different " 5305"applications use different values to map the star rating to the value stored " 5306"in the tag. In order to display the correct number of stars, &kid3; will " 5307"look up a map in this table. The key to look up the mapping is the frame " 5308"name, for example \"RATING\" as used for Vorbis comments or \"IRTD\" for " 5309"RIFF INFO. For ID3v2 tags, a combined key is used consisting of the frame ID " 5310"\"POPM\" of the Popularimeter frame and its \"Email\" field, separated by a " 5311"dot. Therefore, different keys for ID3v2 exist, <abbrev>e.g.</abbrev> \"POPM." 5312"Windows Media Player 9 Series\" for the mapping used by Windows Media Player " 5313"and Explorer, and simply \"POPM\" for POPM frames with an empty \"Email\" " 5314"field. As multiple entries for \"POPM\" can exist, their order is important. " 5315"When &kid3; adds a new Popularimeter frame, it will use the first \"POPM\" " 5316"entry to determine the value to be written into the \"Email\" field. This " 5317"value will then specify the mapping to be used for star ratings. The first " 5318"entry is also used if no key was found, it is therefore the default entry." 5319msgstr "" 5320 5321#. Tag: para 5322#: index.docbook:2368 5323#, no-c-format 5324msgid "" 5325"Besides the <guilabel>Name</guilabel> column containing the keys, the table " 5326"has columns <guilabel>1</guilabel> to <guilabel>5</guilabel> for the values " 5327"to be stored when the corresponding number of stars is given. The other way " 5328"round, the values determine the number of stars which are displayed for the " 5329"value stored in the frame. For instance, the row in the table below contains " 5330"the values 1, 64, 128, 196, 255. The thresholds for the number of stars to " 5331"be displayed lay between these values and are compatible with what the " 5332"&Windows; Explorer uses." 5333msgstr "" 5334 5335#. Tag: title 5336#: index.docbook:2380 5337#, no-c-format 5338msgid "Entry in Rating Table" 5339msgstr "" 5340 5341#. Tag: entry 5342#: index.docbook:2383 5343#, no-c-format 5344msgid "Name" 5345msgstr "" 5346 5347#. Tag: entry 5348#: index.docbook:2383 index.docbook:2386 5349#, no-c-format 5350msgid "<entry>1</entry>" 5351msgstr "" 5352 5353#. Tag: entry 5354#: index.docbook:2383 5355#, no-c-format 5356msgid "<entry>2</entry>" 5357msgstr "" 5358 5359#. Tag: entry 5360#: index.docbook:2383 5361#, no-c-format 5362msgid "<entry>3</entry>" 5363msgstr "" 5364 5365#. Tag: entry 5366#: index.docbook:2383 5367#, no-c-format 5368msgid "<entry>4</entry>" 5369msgstr "" 5370 5371#. Tag: entry 5372#: index.docbook:2383 5373#, no-c-format 5374msgid "<entry>5</entry>" 5375msgstr "" 5376 5377#. Tag: entry 5378#: index.docbook:2386 5379#, no-c-format 5380msgid "<entry>POPM</entry>" 5381msgstr "" 5382 5383#. Tag: entry 5384#: index.docbook:2386 5385#, no-c-format 5386msgid "<entry>64</entry>" 5387msgstr "" 5388 5389#. Tag: entry 5390#: index.docbook:2386 5391#, no-c-format 5392msgid "<entry>128</entry>" 5393msgstr "" 5394 5395#. Tag: entry 5396#: index.docbook:2386 5397#, no-c-format 5398msgid "<entry>196</entry>" 5399msgstr "" 5400 5401#. Tag: entry 5402#: index.docbook:2386 5403#, no-c-format 5404msgid "<entry>255</entry>" 5405msgstr "" 5406 5407#. Tag: entry 5408#: index.docbook:2387 5409#, no-c-format 5410msgid "Range" 5411msgstr "" 5412 5413#. Tag: entry 5414#: index.docbook:2387 5415#, no-c-format 5416msgid "1-31" 5417msgstr "" 5418 5419#. Tag: entry 5420#: index.docbook:2387 5421#, no-c-format 5422msgid "32-95" 5423msgstr "" 5424 5425#. Tag: entry 5426#: index.docbook:2387 5427#, no-c-format 5428msgid "96-159" 5429msgstr "" 5430 5431#. Tag: entry 5432#: index.docbook:2387 5433#, no-c-format 5434msgid "160-223" 5435msgstr "" 5436 5437#. Tag: entry 5438#: index.docbook:2387 5439#, no-c-format 5440msgid "224-255" 5441msgstr "" 5442 5443#. Tag: para 5444#: index.docbook:2392 5445#, no-c-format 5446msgid "" 5447"On the page <guilabel>Files</guilabel> the check box <guilabel>Load last-" 5448"opened files</guilabel> can be marked so that &kid3; will open and select " 5449"the last selected file when it is started the next time. <guilabel>Preserve " 5450"file timestamp</guilabel> can be checked to preserve the file modification " 5451"time stamp. <guilabel>Filename for cover</guilabel> sets the name which is " 5452"suggested when an embedded image is exported to a file. With <guilabel>Text " 5453"encoding (Export, Playlist)</guilabel> the encoding used when writing files " 5454"can be set. The default <guilabel>System</guilabel> can be changed for " 5455"example if playlists have to be used on a different device." 5456msgstr "" 5457 5458#. Tag: para 5459#: index.docbook:2404 5460#, no-c-format 5461msgid "" 5462"If <guilabel>Mark changes</guilabel> is active, changed fields are marked " 5463"with a light gray label background." 5464msgstr "" 5465 5466#. Tag: para 5467#: index.docbook:2408 5468#, no-c-format 5469msgid "" 5470"The section <guilabel>File List</guilabel> determines which files are " 5471"displayed in the file list. A <guilabel>Filter</guilabel> can be used to " 5472"restrict the items in this list to files with supported extensions. To " 5473"explicitly specify which folders to display in the file list or exclude " 5474"certain folders, the options <guilabel>Include folders</guilabel> and " 5475"<guilabel>Exclude folders</guilabel> can be used. They can contain wildcard " 5476"expressions, for instance <filename>*/Music/*</filename> to include only the " 5477"<filename>Music</filename> folder, or <filename>*/iTunes/*</filename> to " 5478"exclude the iTunes folder from the file list. If multiple such expressions " 5479"have to be used, they can be separated by spaces or semicolons." 5480msgstr "" 5481 5482#. Tag: para 5483#: index.docbook:2420 5484#, no-c-format 5485msgid "" 5486"The buttons <guibutton>Filename from tag</guibutton> and <guibutton>Tag from " 5487"filename</guibutton> in section <guilabel>Format</guilabel> open dialogs to " 5488"edit the formats which are available in the <guilabel>Format</guilabel> " 5489"combo boxes (with arrows up and down), which can be found in the <link " 5490"linkend=\"file\">File</link> section of the main window." 5491msgstr "" 5492 5493#. Tag: para 5494#: index.docbook:2427 5495#, no-c-format 5496msgid "" 5497"<guilabel>Filename Format</guilabel> contains options for the format of the " 5498"filenames. The same options as in <guilabel>Tag Format</guilabel> are " 5499"available." 5500msgstr "" 5501 5502#. Tag: para 5503#: index.docbook:2431 5504#, no-c-format 5505msgid "" 5506"The <guilabel>User Actions</guilabel> page contains a table with the " 5507"commands which are available in the context menu of the file list. For " 5508"critical operations such as deleting files, it is advisable to mark " 5509"<guilabel>Confirm</guilabel> to pop up a confirmation dialog before " 5510"executing the command. <guilabel>Output</guilabel> can be marked to see the " 5511"output written by console commands (standard output and standard error). " 5512"<guilabel>Name</guilabel> is the name displayed in the context menu. " 5513"<guilabel>Command</guilabel> is the command line to be executed. Arguments " 5514"can be passed using the following codes:" 5515msgstr "" 5516 5517#. Tag: para 5518#: index.docbook:2445 5519#, no-c-format 5520msgid "%F %{files} File paths (a list if multiple files selected)" 5521msgstr "" 5522 5523#. Tag: para 5524#: index.docbook:2446 5525#, no-c-format 5526msgid "%f %{file} File path to single file" 5527msgstr "" 5528 5529#. Tag: para 5530#: index.docbook:2447 5531#, no-c-format 5532msgid "%uF %{urls} &URL;s (a list if multiple files selected)" 5533msgstr "" 5534 5535#. Tag: para 5536#: index.docbook:2448 5537#, no-c-format 5538msgid "%uf %{url} &URL; to single file" 5539msgstr "" 5540 5541#. Tag: para 5542#: index.docbook:2449 5543#, no-c-format 5544msgid "%d %{directory} Folder" 5545msgstr "" 5546 5547#. Tag: para 5548#: index.docbook:2459 5549#, no-c-format 5550msgid "%b %{browser} Command to start the web browser" 5551msgstr "" 5552 5553#. Tag: para 5554#: index.docbook:2460 5555#, no-c-format 5556msgid "%q %{qmlpath} Base folder of provided QML files" 5557msgstr "" 5558 5559#. Tag: para 5560#: index.docbook:2463 5561#, no-c-format 5562msgid "" 5563"The special code <command>@separator</command> can be set as a command to " 5564"insert a separator into the user actions context menu. Menu items can be put " 5565"into a submenu by enclosing them with <command>@beginmenu</command> and " 5566"<command>@endmenu</command> commands. The name of the submenu is determined " 5567"by the <guilabel>Name</guilabel> column of the <command>@beginmenu</command> " 5568"command." 5569msgstr "" 5570 5571#. Tag: para 5572#: index.docbook:2472 5573#, no-c-format 5574msgid "" 5575"To execute QML scripts, <command>@qml</command> is used as a command name. " 5576"The path to the QML script is passed as a parameter. The provided scripts " 5577"can be found in the folder <filename>%{qmlpath}/script/</filename> (on " 5578"&Linux; typically <filename>/usr/share/kid3/qml/script/</filename>, on " 5579"Windows <filename>qml/script/</filename> inside the installation folder, and " 5580"on &macOS; in the app folder <filename>kid3.app/Contents/Resources/qml/" 5581"script/</filename>). Custom scripts can be stored in any folder. If the QML " 5582"code uses &GUI; components, <command>@qmlview</command> shall be used " 5583"instead of <command>@qml</command>. Additional parameters are passed to the " 5584"QML script where they will be available via the <function>getArguments()</" 5585"function> function. An overview of some functions and properties which are " 5586"available in QML can be found in the appendix <link linkend=\"qml-interface" 5587"\">QML Interface</link>." 5588msgstr "" 5589 5590#. Tag: para 5591#: index.docbook:2488 5592#, no-c-format 5593msgid "" 5594"The command which will be inserted with %{browser} can be defined in the " 5595"<guilabel>Web browser</guilabel> line edit above. Commands starting with " 5596"%{browser} can be used to fetch information about the audio files from the " 5597"web, for instance <screen width=\"40\">\n" 5598"<userinput>%{browser} http://lyricwiki.org/%u{artist}:%u{title}</userinput>\n" 5599"</screen> will query the lyrics for the current song in <ulink url=\"http://" 5600"www.lyricwiki.org\">LyricWiki</ulink>. The \"u\" in %u{artist} and %u{title} " 5601"is used to &URL;-encode the artist %{artist} and song %{title} information. " 5602"It is easy to define your own queries in the same way, <abbrev>e.g.</abbrev> " 5603"an image search with <ulink url=\"http://www.google.com\">Google</ulink>:" 5604msgstr "" 5605 5606#. Tag: screen 5607#: index.docbook:2499 5608#, no-c-format 5609msgid "" 5610"<userinput>%{browser} http://images.google.com/images?q=" 5611"%u{artist}%20%u{album}</userinput>" 5612msgstr "" 5613 5614#. Tag: para 5615#: index.docbook:2501 5616#, no-c-format 5617msgid "" 5618"To add album cover art to tag 2, you can search for images with Google or " 5619"Amazon using the commands described above. The picture can be added to the " 5620"tag with drag and drop. You can also add an image with <guibutton>Add</" 5621"guibutton>, then select the Picture frame and import an image file or paste " 5622"from the clipboard. Picture frames are supported for ID3v2, MP4, FLAC, Ogg " 5623"and ASF tags." 5624msgstr "" 5625 5626#. Tag: para 5627#: index.docbook:2508 5628#, no-c-format 5629msgid "To add and delete entries in the table, a context menu can be used." 5630msgstr "" 5631 5632#. Tag: para 5633#: index.docbook:2512 5634#, no-c-format 5635msgid "" 5636"The <guilabel>Network</guilabel> page contains only a field to insert the " 5637"proxy address and optionally the port, separated by a colon. The proxy will " 5638"be used when importing from an Internet server when the check box is checked." 5639msgstr "" 5640 5641#. Tag: para 5642#: index.docbook:2517 5643#, no-c-format 5644msgid "" 5645"In the <guilabel>Plugins</guilabel> page, available plugins can be enabled " 5646"or disabled. The plugins are separated into two sections. The " 5647"<guilabel>Metadata Plugins & Priority</guilabel> list contains plugins " 5648"which support audio file formats. The order of the plugins is important " 5649"because they are tried from top to bottom. Some formats are supported by " 5650"multiple plugins, so files will be opened with the first plugin supporting " 5651"them. The <guilabel>TaglibMetadata</guilabel> supports most formats, if it " 5652"is at the top of the list, it will open most of the files. If you want to " 5653"use a different plugin for a file format, make sure that it is listed before " 5654"the <guilabel>TaglibMetadata</guilabel> plugin. Details about the metadata " 5655"plugin and why you may want to use them instead of TagLib are listed below." 5656msgstr "" 5657 5658#. Tag: para 5659#: index.docbook:2531 5660#, no-c-format 5661msgid "" 5662"<guilabel>Id3libMetadata</guilabel>: Uses <ulink url=\"http://id3lib." 5663"sourceforge.net\">id3lib</ulink> for ID3v1.1 and ID3v2.3 tags in MP3, MP2, " 5664"AAC files. Supports a few more frame types than TagLib." 5665msgstr "" 5666 5667#. Tag: para 5668#: index.docbook:2535 5669#, no-c-format 5670msgid "" 5671"<guilabel>OggFlacMetadata</guilabel>: Uses <ulink url=\"http://xiph.org/ogg/" 5672"\">libogg</ulink>, <ulink url=\"http://xiph.org/vorbis/\">libvorbis, " 5673"libvorbisfile</ulink> for Ogg files, and additionally <ulink url=\"http://" 5674"flac.sourceforge.net\">libFLAC++ and libFLAC</ulink> for FLAC files. These " 5675"are the official libraries for these formats." 5676msgstr "" 5677 5678#. Tag: para 5679#: index.docbook:2541 5680#, no-c-format 5681msgid "" 5682"<guilabel>TaglibMetadata</guilabel>: Uses <ulink url=\"http://taglib.github." 5683"io/\">TagLib</ulink> which supports a lot of audio file formats. It can be " 5684"used for all audio files supported by &kid3;." 5685msgstr "" 5686 5687#. Tag: para 5688#: index.docbook:2545 5689#, no-c-format 5690msgid "" 5691"<guilabel>Mp4v2Metadata</guilabel>: <ulink url=\"http://code.google.com/p/" 5692"mp4v2\">mp4v2</ulink> was originally used by &kid3; to support M4A files. " 5693"Can be used in case of problems with the M4A support of TagLib." 5694msgstr "" 5695 5696#. Tag: para 5697#: index.docbook:2551 5698#, no-c-format 5699msgid "" 5700"The <guilabel>Available Plugins</guilabel> section lists the remaining " 5701"plugins. Their order is not important, but they can be enabled or disabled " 5702"using the check boxes." 5703msgstr "" 5704 5705#. Tag: para 5706#: index.docbook:2557 5707#, no-c-format 5708msgid "" 5709"<guilabel>AmazonImport</guilabel>: Used for the <guimenuitem>Import from " 5710"Amazon...</guimenuitem> function." 5711msgstr "" 5712 5713#. Tag: para 5714#: index.docbook:2560 5715#, no-c-format 5716msgid "" 5717"<guilabel>DiscogsImport</guilabel>: Used for the <guimenuitem>Import from " 5718"Discogs...</guimenuitem> function." 5719msgstr "" 5720 5721#. Tag: para 5722#: index.docbook:2563 5723#, no-c-format 5724msgid "" 5725"<guilabel>FreedbImport</guilabel>: Used for the <guimenuitem>Import from " 5726"gnudb.org...</guimenuitem> function." 5727msgstr "" 5728 5729#. Tag: para 5730#: index.docbook:2567 5731#, no-c-format 5732msgid "" 5733"<guilabel>MusicBrainzImport</guilabel>: Used for the <guimenuitem>Import " 5734"from MusicBrainz Release...</guimenuitem> function." 5735msgstr "" 5736 5737#. Tag: para 5738#: index.docbook:2571 5739#, no-c-format 5740msgid "" 5741"<guilabel>AcoustidImport</guilabel>: Used for the <guimenuitem>Import from " 5742"MusicBrainz Fingerprint...</guimenuitem> function, which depends on the " 5743"<ulink url=\"http://acoustid.org/chromaprint\">Chromaprint</ulink> and " 5744"<ulink url=\"http://libav.org/\">libav</ulink> libraries." 5745msgstr "" 5746 5747#. Tag: para 5748#: index.docbook:2578 5749#, no-c-format 5750msgid "" 5751"Plugins which are disabled will not be loaded. This can be used to optimize " 5752"resource usage and startup time. The settings on this page take only effect " 5753"after a restart of &kid3;." 5754msgstr "" 5755 5756#. Tag: title 5757#: index.docbook:2592 5758#, no-c-format 5759msgid "The Help Menu" 5760msgstr "" 5761 5762#. Tag: menuchoice 5763#: index.docbook:2597 5764#, no-c-format 5765msgid "<guimenu>Help</guimenu> <guimenuitem>&kid3; Handbook</guimenuitem>" 5766msgstr "" 5767 5768#. Tag: action 5769#: index.docbook:2601 5770#, no-c-format 5771msgid "Opens this handbook." 5772msgstr "" 5773 5774#. Tag: menuchoice 5775#: index.docbook:2605 5776#, no-c-format 5777msgid "<guimenu>Help</guimenu> <guimenuitem>About &kid3;</guimenuitem>" 5778msgstr "" 5779 5780#. Tag: action 5781#: index.docbook:2609 5782#, no-c-format 5783msgid "Displays a short information about &kid3;." 5784msgstr "" 5785 5786#. Tag: title 5787#: index.docbook:2624 5788#, no-c-format 5789msgid "Commands" 5790msgstr "" 5791 5792#. Tag: para 5793#: index.docbook:2625 5794#, no-c-format 5795msgid "" 5796"<command>kid3-cli</command> offers a command-line-interface for &kid3;. If a " 5797"folder path is used, the folder is opened. If one or more file paths are " 5798"given, the common folder is opened and the files are selected. Subsequent " 5799"commands will then work on these files. Commands are specified using " 5800"<option>-c</option> options. If multiple commands are passed, they are " 5801"executed in the given order. If files are modified by the commands, they " 5802"will be saved at the end. If no command options are passed, <command>kid3-" 5803"cli</command> starts in interactive mode. Commands can be entered and will " 5804"operate on the current selection. The following sections list all available " 5805"commands." 5806msgstr "" 5807 5808#. Tag: title 5809#: index.docbook:2639 5810#, no-c-format 5811msgid "Help" 5812msgstr "" 5813 5814#. Tag: cmdsynopsis 5815#: index.docbook:2640 5816#, no-c-format 5817msgid "" 5818"<command>help</command> <arg><replaceable>COMMAND-NAME</replaceable></arg>" 5819msgstr "" 5820 5821#. Tag: para 5822#: index.docbook:2644 5823#, no-c-format 5824msgid "" 5825"Displays help about the parameters of <replaceable>COMMAND-NAME</" 5826"replaceable> or about all commands if no command name is given." 5827msgstr "" 5828 5829#. Tag: title 5830#: index.docbook:2651 5831#, no-c-format 5832msgid "Timeout" 5833msgstr "" 5834 5835#. Tag: cmdsynopsis 5836#: index.docbook:2652 5837#, no-c-format 5838msgid "" 5839"<command>timeout</command> <group> <arg choice=\"plain\">default</arg> <arg " 5840"choice=\"plain\">off</arg> <arg choice=\"plain\"><replaceable>TIME</" 5841"replaceable></arg> </group>" 5842msgstr "" 5843 5844#. Tag: para 5845#: index.docbook:2660 5846#, no-c-format 5847msgid "" 5848"Overwrite the default command timeout. The CLI commands abort after a " 5849"command specific timeout is expired. This timeout is 10 seconds for " 5850"<command>ls</command> and <command>albumart</command>, 60 seconds for " 5851"<command>autoimport</command> and <command>filter</command>, and 3 seconds " 5852"for all other commands. If a huge number of files has to be processed, these " 5853"timeouts may be too restrictive, thus the timeout for all commands can be " 5854"set to <replaceable>TIME</replaceable> ms, switched off altogether or be " 5855"left at the default values." 5856msgstr "" 5857 5858#. Tag: title 5859#: index.docbook:2672 5860#, no-c-format 5861msgid "Quit application" 5862msgstr "" 5863 5864#. Tag: cmdsynopsis 5865#: index.docbook:2673 5866#, no-c-format 5867msgid "<command>exit</command> <arg>force</arg>" 5868msgstr "" 5869 5870#. Tag: para 5871#: index.docbook:2677 5872#, no-c-format 5873msgid "" 5874"Exit application. If there are modified unsaved files, the <parameter class=" 5875"\"command\">force</parameter> parameter is required." 5876msgstr "" 5877 5878#. Tag: title 5879#: index.docbook:2683 5880#, no-c-format 5881msgid "Change folder" 5882msgstr "" 5883 5884#. Tag: cmdsynopsis 5885#: index.docbook:2684 5886#, no-c-format 5887msgid "<command>cd</command> <arg><replaceable>FOLDER</replaceable></arg>" 5888msgstr "" 5889 5890#. Tag: para 5891#: index.docbook:2688 5892#, no-c-format 5893msgid "" 5894"If no <replaceable>FOLDER</replaceable> is given, change to the home folder. " 5895"If a folder is given, change into the folder. If one or more file paths are " 5896"given, change to their common folder and select the files." 5897msgstr "" 5898 5899#. Tag: title 5900#: index.docbook:2695 5901#, no-c-format 5902msgid "Print the filename of the current folder" 5903msgstr "" 5904 5905#. Tag: para 5906#: index.docbook:2699 5907#, no-c-format 5908msgid "Print the filename of the current working folder." 5909msgstr "" 5910 5911#. Tag: title 5912#: index.docbook:2703 5913#, no-c-format 5914msgid "Folder list" 5915msgstr "" 5916 5917#. Tag: para 5918#: index.docbook:2707 5919#, no-c-format 5920msgid "" 5921"List the contents of the current folder. This corresponds to the file list " 5922"in the &kid3; &GUI;. Five characters before the file names show the state of " 5923"the file." 5924msgstr "" 5925 5926#. Tag: para 5927#: index.docbook:2713 5928#, no-c-format 5929msgid "<computeroutput>></computeroutput> File is selected." 5930msgstr "" 5931 5932#. Tag: para 5933#: index.docbook:2715 5934#, no-c-format 5935msgid "<computeroutput>*</computeroutput> File is modified." 5936msgstr "" 5937 5938#. Tag: para 5939#: index.docbook:2717 5940#, no-c-format 5941msgid "" 5942"<computeroutput>1</computeroutput> File has a tag 1, otherwise " 5943"'<computeroutput>-</computeroutput>' is displayed." 5944msgstr "" 5945 5946#. Tag: para 5947#: index.docbook:2719 5948#, no-c-format 5949msgid "" 5950"<computeroutput>2</computeroutput> File has a tag 2, otherwise " 5951"'<computeroutput>-</computeroutput>' is displayed." 5952msgstr "" 5953 5954#. Tag: para 5955#: index.docbook:2721 5956#, no-c-format 5957msgid "" 5958"<computeroutput>3</computeroutput> File has a tag 3, otherwise " 5959"'<computeroutput>-</computeroutput>' is displayed." 5960msgstr "" 5961 5962#. Tag: screen 5963#: index.docbook:2725 5964#, no-c-format 5965msgid "" 5966"<prompt>kid3-cli> </prompt><userinput>ls</userinput><computeroutput>\n" 5967" 1-- 01 Intro.mp3\n" 5968"> 12- 02 We Only Got This One.mp3\n" 5969" *1-- 03 Outro.mp3</computeroutput>" 5970msgstr "" 5971 5972#. Tag: para 5973#: index.docbook:2727 5974#, no-c-format 5975msgid "" 5976"In this example, all files have a tag 1, the second file also has a tag 2 " 5977"and it is selected. The third file is modified." 5978msgstr "" 5979 5980#. Tag: title 5981#: index.docbook:2733 5982#, no-c-format 5983msgid "Save the changed files" 5984msgstr "" 5985 5986#. Tag: title 5987#: index.docbook:2742 5988#, no-c-format 5989msgid "Select file" 5990msgstr "" 5991 5992#. Tag: cmdsynopsis 5993#: index.docbook:2743 5994#, no-c-format 5995msgid "" 5996"<command>select</command> <group> <arg choice=\"plain\">all</arg> <arg " 5997"choice=\"plain\">none</arg> <arg choice=\"plain\">first</arg> <arg choice=" 5998"\"plain\">previous</arg> <arg choice=\"plain\">next</arg> <arg choice=\"plain" 5999"\" rep=\"repeat\"><replaceable>FILE</replaceable></arg> </group>" 6000msgstr "" 6001 6002#. Tag: para 6003#: index.docbook:2754 6004#, no-c-format 6005msgid "" 6006"To select all files, enter <userinput>select all</userinput>, to deselect " 6007"all files, enter <userinput>select none</userinput>. To traverse the files " 6008"in the current folder start with <userinput>select first</userinput>, then " 6009"go forward using <userinput>select next</userinput> or backward using " 6010"<userinput>select previous</userinput>. Specific files can be added to the " 6011"current selection by giving their file names. Wildcards are possible, so " 6012"<userinput>select *.mp3</userinput> will select all MP3 files in the current " 6013"folder." 6014msgstr "" 6015 6016#. Tag: screen 6017#: index.docbook:2764 6018#, no-c-format 6019msgid "" 6020"<prompt>kid3-cli> </prompt><userinput>select first</userinput>\n" 6021"<prompt>kid3-cli> </prompt><userinput>ls</userinput><computeroutput>\n" 6022"> 1-- 01 Intro.mp3\n" 6023" 12- 02 We Only Got This One.mp3\n" 6024" *1-- 03 Outro.mp3</computeroutput>\n" 6025"<prompt>kid3-cli> </prompt><userinput>select next</userinput>\n" 6026"<prompt>kid3-cli> </prompt><userinput>ls</userinput><computeroutput>\n" 6027" 1-- 01 Intro.mp3\n" 6028"> 12- 02 We Only Got This One.mp3\n" 6029" *1-- 03 Outro.mp3</computeroutput>\n" 6030"<prompt>kid3-cli> </prompt><userinput>select *.mp3</userinput>\n" 6031"<prompt>kid3-cli> </prompt><userinput>ls</userinput><computeroutput>\n" 6032"> 1-- 01 Intro.mp3\n" 6033"> 12- 02 We Only Got This One.mp3\n" 6034">*1-- 03 Outro.mp3</computeroutput>" 6035msgstr "" 6036 6037#. Tag: title 6038#: index.docbook:2768 6039#, no-c-format 6040msgid "Select tag" 6041msgstr "" 6042 6043#. Tag: cmdsynopsis 6044#: index.docbook:2769 6045#, no-c-format 6046msgid "" 6047"<command>tag</command> <arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6048msgstr "" 6049 6050#. Tag: para 6051#: index.docbook:2773 6052#, no-c-format 6053msgid "" 6054"Many commands have an optional <replaceable>TAG-NUMBERS</replaceable> " 6055"parameter, which specifies whether the command operates on tag 1, 2, or 3. " 6056"If this parameter is omitted, the default tag numbers are used, which can be " 6057"set by this command. At startup, it is set to <literal>12</literal> which " 6058"means that information is read from tag 2 if available, else from tag 1; " 6059"modifications are done on tag 2. The <option><replaceable>TAG-NUMBERS</" 6060"replaceable></option> can be set to <userinput>1</userinput>, <userinput>2</" 6061"userinput>, or <userinput>3</userinput> to operate only on the corresponding " 6062"tag. If the parameter is omitted, the current setting is displayed." 6063msgstr "" 6064 6065#. Tag: title 6066#: index.docbook:2788 6067#, no-c-format 6068msgid "Get tag frame" 6069msgstr "" 6070 6071#. Tag: cmdsynopsis 6072#: index.docbook:2789 6073#, no-c-format 6074msgid "" 6075"<command>get</command> <group> <arg choice=\"plain\">all</arg> <arg choice=" 6076"\"plain\"><replaceable>FRAME-NAME</replaceable></arg> </group> " 6077"<arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6078msgstr "" 6079 6080#. Tag: para 6081#: index.docbook:2797 6082#, no-c-format 6083msgid "" 6084"This command can be used to read the value of a specific tag frame or get " 6085"information about all tag frames (if the argument is omitted or <option>all</" 6086"option> is used). Modified frames are marked with a '<computeroutput>*</" 6087"computeroutput>'." 6088msgstr "" 6089 6090#. Tag: screen 6091#: index.docbook:2803 6092#, no-c-format 6093msgid "" 6094"<prompt>kid3-cli> </prompt><userinput>get</userinput><computeroutput>\n" 6095"File: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo\n" 6096" Name: 01 Intro.mp3\n" 6097"Tag 1: ID3v1.1\n" 6098" Title Intro\n" 6099" Artist One Hit Wonder\n" 6100" Album Let's Tag\n" 6101" Date 2013\n" 6102" Track Number 1\n" 6103" Genre Pop</computeroutput>\n" 6104"<prompt>kid3-cli> </prompt><userinput>get title</" 6105"userinput><computeroutput>\n" 6106"Intro</computeroutput>" 6107msgstr "" 6108 6109#. Tag: para 6110#: index.docbook:2804 6111#, no-c-format 6112msgid "To save the contents of a picture frame to a file, use" 6113msgstr "" 6114 6115#. Tag: screen 6116#: index.docbook:2805 6117#, no-c-format 6118msgid "<userinput>get picture:'/path/to/folder.jpg'</userinput>" 6119msgstr "" 6120 6121#. Tag: para 6122#: index.docbook:2807 6123#, no-c-format 6124msgid "To save synchronized lyrics to an LRC file, use" 6125msgstr "" 6126 6127#. Tag: screen 6128#: index.docbook:2808 6129#, no-c-format 6130msgid "<userinput>get SYLT:'/path/to/lyrics.lrc'</userinput>" 6131msgstr "" 6132 6133#. Tag: para 6134#: index.docbook:2810 6135#, no-c-format 6136msgid "" 6137"It is possible to get only a specific field from a frame, for example " 6138"<userinput>get POPM.Email</userinput> for the Email field of a Popularimeter " 6139"frame. If a file has multiple frames of the same kind, the different frames " 6140"can be indexed with brackets, for example the first performer from a Vorbis " 6141"comment can be retrieved using <userinput>get performer[0]</userinput>, the " 6142"second using <userinput>get performer[1]</userinput>." 6143msgstr "" 6144 6145#. Tag: para 6146#: index.docbook:2817 6147#, no-c-format 6148msgid "" 6149"The pseudo field name \"selected\" can be used to check if a frame is " 6150"selected, for example <userinput>get artist.selected</userinput> will return " 6151"<computeroutput>1</computeroutput> if the artist frame is selected, else " 6152"<computeroutput>0</computeroutput>." 6153msgstr "" 6154 6155#. Tag: title 6156#: index.docbook:2826 6157#, no-c-format 6158msgid "Set tag frame" 6159msgstr "" 6160 6161#. Tag: cmdsynopsis 6162#: index.docbook:2827 6163#, no-c-format 6164msgid "" 6165"<command>set</command> <arg choice=\"req\"><replaceable>FRAME-NAME</" 6166"replaceable></arg> <arg choice=\"req\"><replaceable>FRAME-VALUE</" 6167"replaceable></arg> <arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6168msgstr "" 6169 6170#. Tag: para 6171#: index.docbook:2833 6172#, no-c-format 6173msgid "" 6174"This command sets the value of a specific tag frame. If <replaceable>FRAME-" 6175"VALUE</replaceable> is empty, the frame is deleted." 6176msgstr "" 6177 6178#. Tag: screen 6179#: index.docbook:2836 6180#, no-c-format 6181msgid "" 6182"<prompt>kid3-cli> </prompt><userinput>set remixer 'O.H. Wonder'</" 6183"userinput>" 6184msgstr "" 6185 6186#. Tag: para 6187#: index.docbook:2837 6188#, no-c-format 6189msgid "To set the contents of a picture frame from a file, use" 6190msgstr "" 6191 6192#. Tag: screen 6193#: index.docbook:2838 6194#, no-c-format 6195msgid "" 6196"<userinput>set picture:'/path/to/folder.jpg' 'Picture Description'</" 6197"userinput>" 6198msgstr "" 6199 6200#. Tag: para 6201#: index.docbook:2840 6202#, no-c-format 6203msgid "To set synchronized lyrics from an LRC file, use" 6204msgstr "" 6205 6206#. Tag: screen 6207#: index.docbook:2841 6208#, no-c-format 6209msgid "" 6210"<userinput>set SYLT:'/path/to/lyrics.lrc' 'Lyrics Description'</userinput>" 6211msgstr "" 6212 6213#. Tag: para 6214#: index.docbook:2843 6215#, no-c-format 6216msgid "" 6217"To set a specific field of a frame, the field name can be given after a dot, " 6218"<abbrev>e.g.</abbrev> to set the Counter field of a Popularimeter frame, use" 6219msgstr "" 6220 6221#. Tag: screen 6222#: index.docbook:2846 6223#, no-c-format 6224msgid "<userinput>set POPM.Counter 5</userinput>" 6225msgstr "" 6226 6227#. Tag: para 6228#: index.docbook:2848 6229#, no-c-format 6230msgid "" 6231"An application for field specifications is the case where you want a custom " 6232"TXXX frame with \"rating\" description instead of a standard Popularimeter " 6233"frame (this seems to be used by some plugins). You can create such a TXXX " 6234"rating frame with <command>kid3-cli</command>, however, you have to first " 6235"create a TXXX frame with description \"rating\" and then set the value of " 6236"this frame to the rating value. <screen width=\"65\">\n" 6237"<prompt>kid3-cli> </prompt><userinput>set rating \"\"</userinput>\n" 6238"<prompt>kid3-cli> </prompt><userinput>set TXXX.Description rating</" 6239"userinput>\n" 6240"<prompt>kid3-cli> </prompt><userinput>set rating 5</userinput>\n" 6241"</screen> The first command will delete an existing POPM frame, because if " 6242"such a frame exists, <userinput>set rating 5</userinput> would set the POPM " 6243"frame and not the TXXX frame. Another possibility would be to use " 6244"<userinput>set TXXX.Text 5</userinput>, but this would only work if there is " 6245"no other TXXX frame present." 6246msgstr "" 6247 6248#. Tag: para 6249#: index.docbook:2862 6250#, no-c-format 6251msgid "" 6252"To set multiple frames of the same kind, an index can be given in brackets, " 6253"<abbrev>e.g.</abbrev> to set multiple performers in a Vorbis comment, use" 6254msgstr "" 6255 6256#. Tag: screen 6257#: index.docbook:2865 6258#, no-c-format 6259msgid "" 6260"<prompt>kid3-cli> </prompt><userinput>set performer[0] 'Liza don Getti " 6261"(soprano)'</userinput>\n" 6262"<prompt>kid3-cli> </prompt><userinput>set performer[1] 'Joe Barr " 6263"(piano)'</userinput>" 6264msgstr "" 6265 6266#. Tag: para 6267#: index.docbook:2867 6268#, no-c-format 6269msgid "" 6270"To select certain frames before a copy, paste or remove action, the pseudo " 6271"field name \"selected\" can be used. Normally, all frames are selected, to " 6272"deselect all, use <userinput>set '*.selected' 0</userinput>, then for " 6273"example <userinput>set artist.selected 1</userinput> to select the artist " 6274"frame." 6275msgstr "" 6276 6277#. Tag: title 6278#: index.docbook:2876 6279#, no-c-format 6280msgid "Revert" 6281msgstr "" 6282 6283#. Tag: para 6284#: index.docbook:2880 6285#, no-c-format 6286msgid "" 6287"Revert all modifications in the selected files (or all files if no files are " 6288"selected)." 6289msgstr "" 6290 6291#. Tag: title 6292#: index.docbook:2886 6293#, no-c-format 6294msgid "Import from file" 6295msgstr "" 6296 6297#. Tag: cmdsynopsis 6298#: index.docbook:2887 6299#, no-c-format 6300msgid "" 6301"<command>import</command> <arg choice=\"req\"><replaceable>FILE</" 6302"replaceable></arg> <arg choice=\"req\"><replaceable>FORMAT-NAME</" 6303"replaceable></arg> <arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6304msgstr "" 6305 6306#. Tag: para 6307#: index.docbook:2893 6308#, no-c-format 6309msgid "" 6310"Tags are imported from the file <replaceable>FILE</replaceable> in the " 6311"format with the name <replaceable>FORMAT-NAME</replaceable> (<abbrev>e.g.</" 6312"abbrev> <userinput>\"CSV unquoted\"</userinput>, see <link linkend=\"import-" 6313"text\">Import</link>)." 6314msgstr "" 6315 6316#. Tag: para 6317#: index.docbook:2898 6318#, no-c-format 6319msgid "" 6320"If <userinput>tags</userinput> is given for <replaceable>FILE</replaceable>, " 6321"tags are imported from other tags. Instead of <replaceable>FORMAT-NAME</" 6322"replaceable> parameters <replaceable>SOURCE</replaceable> and " 6323"<replaceable>EXTRACTION</replaceable> are required, see <link linkend=" 6324"\"import-tags\">Import from Tags</link>. To apply the import from tags on " 6325"the selected files, use <userinput>tagsel</userinput> instead of " 6326"<userinput>tags</userinput>. This function also supports output of the " 6327"extracted value by using an <replaceable>EXTRACTION</replaceable> with the " 6328"value <userinput>%{__return}(.+)</userinput>." 6329msgstr "" 6330 6331#. Tag: title 6332#: index.docbook:2912 6333#, no-c-format 6334msgid "Automatic import" 6335msgstr "" 6336 6337#. Tag: cmdsynopsis 6338#: index.docbook:2913 6339#, no-c-format 6340msgid "" 6341"<command>autoimport</command> <arg><replaceable>PROFILE-NAME</replaceable></" 6342"arg> <arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6343msgstr "" 6344 6345#. Tag: para 6346#: index.docbook:2918 6347#, no-c-format 6348msgid "" 6349"Batch import using profile <replaceable>PROFILE-NAME</replaceable> (see " 6350"<link linkend=\"batch-import\">Automatic Import</link>, <userinput>\"All\"</" 6351"userinput> is used if omitted)." 6352msgstr "" 6353 6354#. Tag: title 6355#: index.docbook:2925 6356#, no-c-format 6357msgid "Download album cover artwork" 6358msgstr "" 6359 6360#. Tag: cmdsynopsis 6361#: index.docbook:2926 6362#, no-c-format 6363msgid "" 6364"<command>albumart</command> <arg choice=\"req\"><replaceable>URL</" 6365"replaceable></arg> <arg>all</arg>" 6366msgstr "" 6367 6368#. Tag: para 6369#: index.docbook:2931 6370#, no-c-format 6371msgid "" 6372"Set the album artwork by downloading a picture from <replaceable>URL</" 6373"replaceable>. The rules defined in the <link linkend=\"browse_pictures" 6374"\">Browse Cover Art</link> dialog are used to transform general &URL;s " 6375"(<abbrev>e.g.</abbrev> from Amazon) to a picture &URL;. To set the album " 6376"cover from a local picture file, use the <link linkend=\"cli-set\">set</" 6377"link> command." 6378msgstr "" 6379 6380#. Tag: screen 6381#: index.docbook:2937 6382#, no-c-format 6383msgid "" 6384"<prompt>kid3-cli> </prompt><userinput>albumart\n" 6385"http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC</userinput>" 6386msgstr "" 6387 6388#. Tag: title 6389#: index.docbook:2941 6390#, no-c-format 6391msgid "Export to file" 6392msgstr "" 6393 6394#. Tag: cmdsynopsis 6395#: index.docbook:2942 6396#, no-c-format 6397msgid "" 6398"<command>export</command> <arg choice=\"req\"><replaceable>FILE</" 6399"replaceable></arg> <arg choice=\"req\"><replaceable>FORMAT-NAME</" 6400"replaceable></arg> <arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6401msgstr "" 6402 6403#. Tag: para 6404#: index.docbook:2948 6405#, no-c-format 6406msgid "" 6407"Tags are exported to file <replaceable>FILE</replaceable> in the format with " 6408"the name <replaceable>FORMAT-NAME</replaceable> (<abbrev>e.g.</abbrev> " 6409"<userinput>\"CSV unquoted\"</userinput>, see <link linkend=\"export" 6410"\">Export</link>)." 6411msgstr "" 6412 6413#. Tag: title 6414#: index.docbook:2956 6415#, no-c-format 6416msgid "Create playlist" 6417msgstr "" 6418 6419#. Tag: para 6420#: index.docbook:2960 6421#, no-c-format 6422msgid "" 6423"Create playlist in the format set in the configuration, see <link linkend=" 6424"\"create-playlist\">Create Playlist</link>." 6425msgstr "" 6426 6427#. Tag: title 6428#: index.docbook:2966 6429#, no-c-format 6430msgid "Apply filename format" 6431msgstr "" 6432 6433#. Tag: para 6434#: index.docbook:2970 6435#, no-c-format 6436msgid "" 6437"Apply file name format set in the configuration, see <link linkend=\"apply-" 6438"filename-format\">Apply Filename Format</link>." 6439msgstr "" 6440 6441#. Tag: title 6442#: index.docbook:2975 6443#, no-c-format 6444msgid "Apply tag format" 6445msgstr "" 6446 6447#. Tag: para 6448#: index.docbook:2979 6449#, no-c-format 6450msgid "" 6451"Apply tag name format set in the configuration, see <link linkend=\"apply-" 6452"tag-format\">Apply Tag Format</link>." 6453msgstr "" 6454 6455#. Tag: title 6456#: index.docbook:2984 index.docbook:3813 6457#, no-c-format 6458msgid "Apply text encoding" 6459msgstr "" 6460 6461#. Tag: para 6462#: index.docbook:2988 6463#, no-c-format 6464msgid "" 6465"Apply text encoding set in the configuration, see <link linkend=\"apply-text-" 6466"encoding\">Apply Text Encoding</link>." 6467msgstr "" 6468 6469#. Tag: title 6470#: index.docbook:2993 6471#, no-c-format 6472msgid "Rename folder" 6473msgstr "" 6474 6475#. Tag: cmdsynopsis 6476#: index.docbook:2994 6477#, no-c-format 6478msgid "" 6479"<command>renamedir</command> <arg><replaceable>FORMAT</replaceable></arg> " 6480"<group> <arg choice=\"plain\">create</arg> <arg choice=\"plain\">rename</" 6481"arg> <arg choice=\"plain\">dryrun</arg> </group> <arg><replaceable>TAG-" 6482"NUMBERS</replaceable></arg>" 6483msgstr "" 6484 6485#. Tag: para 6486#: index.docbook:3004 6487#, no-c-format 6488msgid "" 6489"Rename or create folders from the values in the tags according to a given " 6490"<replaceable>FORMAT</replaceable> (<abbrev>e.g.</abbrev> <userinput>" 6491"%{artist} - %{album}</userinput>, see <link linkend=\"rename-directory" 6492"\">Rename Folder</link>), if no format is given, the format defined in the " 6493"<guilabel>Rename folder</guilabel> dialog is used. The default mode is " 6494"<option>rename</option>; to create folders, <option>create</option> must be " 6495"given explicitly. The rename actions will be performed immediately, to just " 6496"see what would be done, use the <option>dryrun</option> option." 6497msgstr "" 6498 6499#. Tag: title 6500#: index.docbook:3017 6501#, no-c-format 6502msgid "Number tracks" 6503msgstr "" 6504 6505#. Tag: cmdsynopsis 6506#: index.docbook:3018 6507#, no-c-format 6508msgid "" 6509"<command>numbertracks</command> <arg><replaceable>TRACK-NUMBER</" 6510"replaceable></arg> <arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6511msgstr "" 6512 6513#. Tag: para 6514#: index.docbook:3023 6515#, no-c-format 6516msgid "" 6517"Number the selected tracks starting with <replaceable>TRACK-NUMBER</" 6518"replaceable> (<literal>1</literal> if omitted)." 6519msgstr "" 6520 6521#. Tag: title 6522#: index.docbook:3029 6523#, no-c-format 6524msgid "Filter" 6525msgstr "" 6526 6527#. Tag: cmdsynopsis 6528#: index.docbook:3030 6529#, no-c-format 6530msgid "" 6531"<command>filter</command> <group> <arg choice=\"plain\"><replaceable>FILTER-" 6532"NAME</replaceable></arg> <arg choice=\"plain\"><replaceable>FILTER-FORMAT</" 6533"replaceable></arg> </group>" 6534msgstr "" 6535 6536#. Tag: para 6537#: index.docbook:3037 6538#, no-c-format 6539msgid "" 6540"Filter the files so that only the files matching the <replaceable>FILTER-" 6541"FORMAT</replaceable> are visible. The name of a predefined filter expression " 6542"(<abbrev>e.g.</abbrev> <userinput>\"Filename Tag Mismatch\"</userinput>) can " 6543"be used instead of a filter expression, see <link linkend=\"filter\">Filter</" 6544"link>." 6545msgstr "" 6546 6547#. Tag: screen 6548#: index.docbook:3043 6549#, no-c-format 6550msgid "" 6551"<prompt>kid3-cli> </prompt><userinput>filter '%{title} contains \"tro\"'</" 6552"userinput><computeroutput>\n" 6553"Started\n" 6554" /home/urs/One Hit Wonder - Let's Tag\n" 6555"+ 01 Intro.mp3\n" 6556"- 02 We Only Got This One.mp3\n" 6557"+ 03 Outro.mp3\n" 6558"Finished</computeroutput>\n" 6559"<prompt>kid3-cli> </prompt><userinput>ls</userinput><computeroutput>\n" 6560" 1-- 01 Intro.mp3\n" 6561" 1-- 03 Outro.mp3</computeroutput>\n" 6562"<prompt>kid3-cli> </prompt><userinput>filter All</" 6563"userinput><computeroutput>\n" 6564"Started\n" 6565" /home/urs/One Hit Wonder - Let's Tag\n" 6566"+ 01 Intro.mp3\n" 6567"+ 02 We Only Got This One.mp3\n" 6568"+ 03 Outro.mp3\n" 6569"Finished</computeroutput>\n" 6570"<prompt>kid3-cli> </prompt><userinput>ls</userinput><computeroutput>\n" 6571" 1-- 01 Intro.mp3\n" 6572" 12- 02 We Only Got This One.mp3\n" 6573" 1-- 03 Outro.mp3</computeroutput>" 6574msgstr "" 6575 6576#. Tag: title 6577#: index.docbook:3047 6578#, no-c-format 6579msgid "Convert ID3v2.3 to ID3v2.4" 6580msgstr "" 6581 6582#. Tag: title 6583#: index.docbook:3054 6584#, no-c-format 6585msgid "Convert ID3v2.4 to ID3v2.3" 6586msgstr "" 6587 6588#. Tag: title 6589#: index.docbook:3061 6590#, no-c-format 6591msgid "Filename from tag" 6592msgstr "" 6593 6594#. Tag: cmdsynopsis 6595#: index.docbook:3062 6596#, no-c-format 6597msgid "" 6598"<command>fromtag</command> <arg><replaceable>FORMAT</replaceable></arg> " 6599"<arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6600msgstr "" 6601 6602#. Tag: para 6603#: index.docbook:3067 6604#, no-c-format 6605msgid "" 6606"Set the file names of the selected files from values in the tags, for " 6607"example <userinput>fromtag '%{track} - %{title}' 1</userinput>. If no format " 6608"is specified, the format set in the &GUI; is used." 6609msgstr "" 6610 6611#. Tag: title 6612#: index.docbook:3074 6613#, no-c-format 6614msgid "Tag from filename" 6615msgstr "" 6616 6617#. Tag: cmdsynopsis 6618#: index.docbook:3075 6619#, no-c-format 6620msgid "" 6621"<command>totag</command> <arg><replaceable>FORMAT</replaceable></arg> " 6622"<arg><replaceable>TAG-NUMBERS</replaceable></arg>" 6623msgstr "" 6624 6625#. Tag: para 6626#: index.docbook:3080 6627#, no-c-format 6628msgid "" 6629"Set the tag frames from the file names, for example <userinput>totag " 6630"'%{albumartist} - %{album}/%{track} %{title}' 2</userinput>. If no format is " 6631"specified, the format set in the &GUI; is used. If the format of the " 6632"filename does not match this pattern, a few other commonly used formats are " 6633"tried." 6634msgstr "" 6635 6636#. Tag: title 6637#: index.docbook:3089 6638#, no-c-format 6639msgid "Tag to other tag" 6640msgstr "" 6641 6642#. Tag: cmdsynopsis 6643#: index.docbook:3090 6644#, no-c-format 6645msgid "" 6646"<command>syncto</command> <arg choice=\"req\"><replaceable>TAG-NUMBER</" 6647"replaceable></arg>" 6648msgstr "" 6649 6650#. Tag: para 6651#: index.docbook:3094 6652#, no-c-format 6653msgid "" 6654"Copy the tag frames from one tag to the other tag, <abbrev>e.g.</abbrev> to " 6655"set the ID3v2 tag from the ID3v1 tag, use <userinput>syncto 2</userinput>." 6656msgstr "" 6657 6658#. Tag: title 6659#: index.docbook:3100 6660#, no-c-format 6661msgid "Copy" 6662msgstr "" 6663 6664#. Tag: cmdsynopsis 6665#: index.docbook:3101 6666#, no-c-format 6667msgid "" 6668"<command>copy</command> <arg><replaceable>TAG-NUMBER</replaceable></arg>" 6669msgstr "" 6670 6671#. Tag: para 6672#: index.docbook:3105 6673#, no-c-format 6674msgid "" 6675"Copy the tag frames of the selected file to the internal copy buffer. They " 6676"can then be set on another file using the <command>paste</command> command." 6677msgstr "" 6678 6679#. Tag: para 6680#: index.docbook:3109 6681#, no-c-format 6682msgid "" 6683"To copy only a subset of the frames, use the \"selected\" pseudo field with " 6684"the <command>set</command> command. For example, to copy only the disc " 6685"number and copyright frames, use" 6686msgstr "" 6687 6688#. Tag: screen 6689#: index.docbook:3113 6690#, no-c-format 6691msgid "" 6692"<userinput>set '*.selected' 0</userinput>\n" 6693"<userinput>set discnumber.selected 1</userinput>\n" 6694"<userinput>set copyright.selected 1</userinput>\n" 6695"<userinput>copy</userinput>" 6696msgstr "" 6697 6698#. Tag: title 6699#: index.docbook:3118 6700#, no-c-format 6701msgid "Paste" 6702msgstr "" 6703 6704#. Tag: cmdsynopsis 6705#: index.docbook:3119 6706#, no-c-format 6707msgid "" 6708"<command>paste</command> <arg><replaceable>TAG-NUMBER</replaceable></arg>" 6709msgstr "" 6710 6711#. Tag: para 6712#: index.docbook:3123 6713#, no-c-format 6714msgid "" 6715"Set tag frames from the contents of the <command>copy</command> buffer in " 6716"the selected files." 6717msgstr "" 6718 6719#. Tag: title 6720#: index.docbook:3129 6721#, no-c-format 6722msgid "Remove" 6723msgstr "" 6724 6725#. Tag: cmdsynopsis 6726#: index.docbook:3130 6727#, no-c-format 6728msgid "" 6729"<command>remove</command> <arg><replaceable>TAG-NUMBER</replaceable></arg>" 6730msgstr "" 6731 6732#. Tag: para 6733#: index.docbook:3134 6734#, no-c-format 6735msgid "Remove a tag." 6736msgstr "" 6737 6738#. Tag: para 6739#: index.docbook:3136 6740#, no-c-format 6741msgid "" 6742"It is possible to remove only a subset of the frames by selecting them as " 6743"described in the <link linkend=\"cli-copy\"><command>copy</command> command</" 6744"link>." 6745msgstr "" 6746 6747#. Tag: title 6748#: index.docbook:3143 6749#, no-c-format 6750msgid "Configure Kid3" 6751msgstr "" 6752 6753#. Tag: cmdsynopsis 6754#: index.docbook:3144 6755#, no-c-format 6756msgid "" 6757"<command>config</command> <arg><replaceable>OPTION</replaceable></arg> " 6758"<arg><replaceable>VALUE</replaceable></arg>" 6759msgstr "" 6760 6761#. Tag: para 6762#: index.docbook:3149 6763#, no-c-format 6764msgid "Query or set a configuration option." 6765msgstr "" 6766 6767#. Tag: para 6768#: index.docbook:3151 6769#, no-c-format 6770msgid "" 6771"The <replaceable>OPTION</replaceable> consists of a group name and a " 6772"property name separated by a dot. When no <replaceable>OPTION</replaceable> " 6773"is given, all available groups are displayed. If only a group name is given, " 6774"all available properties of the group are displayed. For a given group and " 6775"property, the currently configured value is displayed. To change the " 6776"setting, the new value can be passed as a second argument." 6777msgstr "" 6778 6779#. Tag: para 6780#: index.docbook:3158 6781#, no-c-format 6782msgid "" 6783"If the value of a setting is a list, all list elements have to be given as " 6784"arguments. This means that to append an element to an existing list of " 6785"elements, all existing elements have to be passed followed by the new " 6786"element. In such a situation, it is easier to use the JSON mode, where the " 6787"current list can be copied with the new element appended." 6788msgstr "" 6789 6790#. Tag: title 6791#: index.docbook:3169 6792#, no-c-format 6793msgid "Examples" 6794msgstr "" 6795 6796#. Tag: para 6797#: index.docbook:3170 6798#, no-c-format 6799msgid "" 6800"Set title containing an apostrophe. Commands passed to <command>kid3-cli</" 6801"command> with <parameter>-c</parameter> have to be in quotes if they do not " 6802"only consist of a single word. If such a command itself has an argument " 6803"containing spaces, that argument has to be quoted too. In &UNIX; shells " 6804"single or double quotes can be used, but on the Windows Command Prompt, it " 6805"is important that the outer quoting is done using double quotes and inside " 6806"these quotes, single quotes are used. If the text inside the single quotes " 6807"contains a single quote, it has to be escaped using a backslash character, " 6808"as shown in the following example:" 6809msgstr "" 6810 6811#. Tag: screen 6812#: index.docbook:3179 6813#, no-c-format 6814msgid "" 6815"<userinput>kid3-cli -c \"set title 'I\\'ll be there for you'\" /path/to/" 6816"folder</userinput>" 6817msgstr "" 6818 6819#. Tag: para 6820#: index.docbook:3181 6821#, no-c-format 6822msgid "" 6823"Set album cover in all files of a folder using the batch import function:" 6824msgstr "" 6825 6826#. Tag: screen 6827#: index.docbook:3183 6828#, no-c-format 6829msgid "" 6830"<userinput>kid3-cli -c \"autoimport 'Cover Art'\" /path/to/folder</userinput>" 6831msgstr "" 6832 6833#. Tag: para 6834#: index.docbook:3185 6835#, no-c-format 6836msgid "" 6837"Remove comment frames and apply the tag format in both tags of all MP3 files " 6838"of a folder:" 6839msgstr "" 6840 6841#. Tag: screen 6842#: index.docbook:3187 6843#, no-c-format 6844msgid "" 6845"<userinput>kid3-cli -c \"set comment '' 1\" -c \"set comment '' 2\" \\\n" 6846"-c \"tagformat 1\" -c \"tagformat 2\" /path/to/folder/*.mp3</userinput>" 6847msgstr "" 6848 6849#. Tag: para 6850#: index.docbook:3189 6851#, no-c-format 6852msgid "" 6853"Automatically import tag 2, synchronize to tag 1, set file names from tag 2 " 6854"and finally create a playlist:" 6855msgstr "" 6856 6857#. Tag: screen 6858#: index.docbook:3191 6859#, no-c-format 6860msgid "" 6861"<userinput>kid3-cli -c autoimport -c \"syncto 1\" -c fromtag -c playlist \\\n" 6862" /path/to/folder/*.mp3</userinput>" 6863msgstr "" 6864 6865#. Tag: para 6866#: index.docbook:3193 6867#, no-c-format 6868msgid "" 6869"For all files with an ID3v2.4.0 tag, convert to ID3v2.3.0 and remove the " 6870"arranger frame:" 6871msgstr "" 6872 6873#. Tag: screen 6874#: index.docbook:3195 6875#, no-c-format 6876msgid "" 6877"<userinput>kid3-cli -c \"filter 'ID3v2.4.0 Tag'\" -c \"select all\" -c to23 " 6878"\\\n" 6879" -c \"set arranger ''\" /path/to/folder</userinput>" 6880msgstr "" 6881 6882#. Tag: para 6883#: index.docbook:3197 6884#, no-c-format 6885msgid "" 6886"This Python script uses <command>kid3-cli</command> to generate iTunes Sound " 6887"Check iTunNORM frames from replay gain information." 6888msgstr "" 6889 6890#. Tag: programlisting 6891#: index.docbook:3199 6892#, no-c-format 6893msgid "" 6894"<![CDATA[\n" 6895"#!/usr/bin/env python3\n" 6896"# Generate iTunes Sound Check from ReplayGain.\n" 6897"import os, sys, subprocess\n" 6898"\n" 6899"def rg2sc(dirpath):\n" 6900" for root, dirs, files in os.walk(dirpath):\n" 6901" for name in files:\n" 6902" if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):\n" 6903" fn = os.path.join(root, name)\n" 6904" rg = subprocess.check_output([\n" 6905" 'kid3-cli', '-c', 'get \"replaygain_track_gain\"',\n" 6906" fn]).strip()\n" 6907" if rg.endswith(b' dB'):\n" 6908" rg = rg[:-3]\n" 6909" try:\n" 6910" rg = float(rg)\n" 6911" except ValueError:\n" 6912" print('Value %s of %s in not a float' % (rg, fn))\n" 6913" continue\n" 6914" sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10\n" 6915" subprocess.call([\n" 6916" 'kid3-cli', '-c', 'set iTunNORM \"%s\"' % sc, fn])\n" 6917"\n" 6918"if __name__ == '__main__':\n" 6919" rg2sc(sys.argv[1])\n" 6920"]]>" 6921msgstr "" 6922 6923#. Tag: title 6924#: index.docbook:3203 6925#, no-c-format 6926msgid "&JSON; Format" 6927msgstr "" 6928 6929#. Tag: para 6930#: index.docbook:3204 6931#, no-c-format 6932msgid "" 6933"In order to make it easier to parse results from <command>kid3-cli</" 6934"command>, it is possible to get the output in &JSON; format. When the " 6935"request is in &JSON; format, the response will also be &JSON;. A compact " 6936"format of the request will also give a compact representation of the " 6937"response. If the request contains an \"id\" field, it is assumed to be a " 6938"&JSON;-RPC request and the response will contain a \"jsonrpc\" field and the " 6939"\"id\" of the request. The request format uses the same commands as the " 6940"standard CLI, the \"method\" field contains the command and the parameters " 6941"(if any) are given in the \"params\" list. The response contains a \"result" 6942"\" object, which can also be null if the corresponding <command>kid3-cli</" 6943"command> command does not return a result. In case of an error, an \"error\" " 6944"object is returned with \"code\" and \"message\" fields as used in &JSON;-" 6945"RPC." 6946msgstr "" 6947 6948#. Tag: screen 6949#: index.docbook:3218 6950#, no-c-format 6951msgid "" 6952"<prompt>kid3-cli> </prompt><userinput>{\"method\":\"set\",\"params\":" 6953"[\"artist\",\"An Artist\"]}</userinput>\n" 6954"<computeroutput>{\"result\":null}</computeroutput>\n" 6955"<prompt>kid3-cli> </prompt><userinput>{\"method\":\"get\",\"params\":" 6956"[\"artist\",2]}</userinput>\n" 6957"<computeroutput>{\"result\":\"An Artist\"}</computeroutput>\n" 6958"<prompt>kid3-cli> </prompt><userinput>{\"method\": \"get\", \"params\": " 6959"[\"artist\"]}</userinput>\n" 6960"<computeroutput>{\n" 6961" \"result\": \"An Artist\"\n" 6962"}\n" 6963"</computeroutput>\n" 6964"<prompt>kid3-cli> </prompt><userinput>{\"jsonrpc\":\"2.0\",\"id\":\"123\"," 6965"\"method\":\"get\",\"params\":[\"artist\"]}</userinput>\n" 6966"<computeroutput>{\"id\":\"123\",\"jsonrpc\":\"2.0\",\"result\":\"An Artist\"}" 6967"</computeroutput>" 6968msgstr "" 6969 6970#. Tag: title 6971#: index.docbook:3227 6972#, no-c-format 6973msgid "Credits and License" 6974msgstr "" 6975 6976#. Tag: para 6977#: index.docbook:3229 6978#, no-c-format 6979msgid "&kid3;" 6980msgstr "" 6981 6982#. Tag: para 6983#: index.docbook:3232 6984#, no-c-format 6985msgid "" 6986"Program written by Urs Fleisch <email>ufleisch@users.sourceforge.net</email>" 6987msgstr "" 6988 6989#. Tag: trans_comment 6990#: index.docbook:3236 6991#, no-c-format 6992msgid "CREDIT_FOR_TRANSLATORS" 6993msgstr "" 6994 6995#. Tag: chapter 6996#: index.docbook:3236 6997#, no-c-format 6998msgid "&underFDL; &underGPL;" 6999msgstr "" 7000 7001#. Tag: title 7002#: index.docbook:3244 7003#, no-c-format 7004msgid "Installation" 7005msgstr "" 7006 7007#. Tag: title 7008#: index.docbook:3247 7009#, no-c-format 7010msgid "How to obtain &kid3;" 7011msgstr "" 7012 7013#. Tag: para 7014#: index.docbook:3249 7015#, no-c-format 7016msgid "" 7017"&kid3; can be found at <ulink url=\"https://kid3.kde.org\">https://kid3.kde." 7018"org</ulink>." 7019msgstr "" 7020 7021#. Tag: title 7022#: index.docbook:3256 7023#, no-c-format 7024msgid "Requirements" 7025msgstr "" 7026 7027#. Tag: para 7028#: index.docbook:3258 7029#, no-c-format 7030msgid "" 7031"&kid3; needs <ulink url=\"https://www.qt.io\">&Qt;</ulink>. <ulink url=" 7032"\"http://www.kde.org\">&kde;</ulink> is recommended but not necessary, as " 7033"&kid3; can also be compiled as a &Qt; application. &kid3; can be compiled " 7034"for systems where these libraries are available, <abbrev>e.g.</abbrev> for " 7035"GNU/&Linux;, &Windows; and &macOS;. To tag Ogg/Vorbis files, <ulink url=" 7036"\"http://xiph.org/ogg/\">libogg</ulink>, <ulink url=\"http://xiph.org/vorbis/" 7037"\">libvorbis and libvorbisfile</ulink> are required, for FLAC files <ulink " 7038"url=\"http://flac.sourceforge.net\">libFLAC++ and libFLAC</ulink>. <ulink " 7039"url=\"http://id3lib.sourceforge.net\">id3lib</ulink> is used for MP3 files. " 7040"These four formats are also supported by <ulink url=\"http://taglib.github." 7041"io/\">TagLib</ulink>, which can also handle Opus, MPC, APE, MP2, Speex, " 7042"TrueAudio, WavPack, WMA, WAV, AIFF files and tracker modules. To import from " 7043"acoustic fingerprints, <ulink url=\"http://acoustid.org/chromaprint" 7044"\">Chromaprint</ulink> and <ulink url=\"http://libav.org/\">libav</ulink> " 7045"are used." 7046msgstr "" 7047 7048#. Tag: para 7049#: index.docbook:3280 7050#, no-c-format 7051msgid "" 7052"&kid3; is available for most &Linux; distributions, &Windows; and &macOS;. " 7053"Links can be found on <ulink url=\"https://kid3.kde.org\"> https://kid3.kde." 7054"org</ulink>." 7055msgstr "" 7056 7057#. Tag: title 7058#: index.docbook:3289 7059#, no-c-format 7060msgid "Compilation and Installation" 7061msgstr "" 7062 7063#. Tag: para 7064#: index.docbook:3291 7065#, no-c-format 7066msgid "" 7067"You can compile &kid3; with or without &kde;. Without &kde;, &kid3; is a " 7068"simple &Qt; application and lacks some configuration and session features." 7069msgstr "" 7070 7071#. Tag: para 7072#: index.docbook:3295 7073#, no-c-format 7074msgid "For a &kde; version, go into the top folder and type" 7075msgstr "" 7076 7077#. Tag: screen 7078#: index.docbook:3297 7079#, no-c-format 7080msgid "" 7081"<prompt>%</prompt> <userinput>cmake .</userinput>\n" 7082"<prompt>%</prompt> <userinput>make</userinput>\n" 7083"<prompt>%</prompt> <userinput>make install</userinput>" 7084msgstr "" 7085 7086#. Tag: para 7087#: index.docbook:3299 7088#, no-c-format 7089msgid "" 7090"To compile for different versions of &Qt; or &kde;, set the corresponding " 7091"<userinput>cmake</userinput> options." 7092msgstr "" 7093 7094#. Tag: para 7095#: index.docbook:3303 7096#, no-c-format 7097msgid "" 7098"If not all libraries are present, &kid3; is built with reduced " 7099"functionality. So you should take care to have all desired development " 7100"packages installed. On the other side, <userinput>cmake</userinput>-options " 7101"control which libraries are compiled in. The default is <userinput>-" 7102"DWITH_TAGLIB:BOOL=ON -DWITH_MP4V2:BOOL=OFF -DWITH_ID3LIB:BOOL=ON -" 7103"DWITH_CHROMAPRINT:BOOL=ON -DWITH_VORBIS:BOOL=ON -DWITH_FLAC:BOOL=ON </" 7104"userinput>. These options can be disabled using <userinput>OFF</userinput>." 7105msgstr "" 7106 7107#. Tag: para 7108#: index.docbook:3313 7109#, no-c-format 7110msgid "" 7111"To build &kid3; as a &Qt; application without &kde;, use the " 7112"<userinput>cmake</userinput> option <userinput>-DWITH_APPS=Qt</userinput>. " 7113"To build both a &kde; and a &Qt; application, set <userinput>-DWITH_APPS=" 7114"\"Qt;KDE\"</userinput>." 7115msgstr "" 7116 7117#. Tag: para 7118#: index.docbook:3319 7119#, no-c-format 7120msgid "" 7121"To use a specific &Qt; installation, set <userinput>-DQT_QMAKE_EXECUTABLE=/" 7122"path/to/qmake</userinput>." 7123msgstr "" 7124 7125#. Tag: para 7126#: index.docbook:3323 7127#, no-c-format 7128msgid "" 7129"Generation of RPM-Packages is supported by the file <filename>kid3.spec</" 7130"filename>, for &Debian; Packages, the script <filename>build-deb.sh</" 7131"filename> is available." 7132msgstr "" 7133 7134#. Tag: para 7135#: index.docbook:3329 7136#, no-c-format 7137msgid "" 7138"The &Qt; application can also be compiled for &Windows; and &macOS;. The " 7139"script <filename>buildlibs.sh</filename> can be used to download and build " 7140"all required libraries and create a &kid3; package." 7141msgstr "" 7142 7143#. Tag: title 7144#: index.docbook:3338 7145#, no-c-format 7146msgid "Configuration" 7147msgstr "" 7148 7149#. Tag: para 7150#: index.docbook:3340 7151#, no-c-format 7152msgid "" 7153"With &kde;, the settings are stored in <filename>.config/kid3rc</filename>. " 7154"As a &Qt; application, this file is in <filename>.config/Kid3/Kid3.conf</" 7155"filename>. On &Windows;, the configuration is stored in the registry. on " 7156"&macOS; in a plist file." 7157msgstr "" 7158 7159#. Tag: para 7160#: index.docbook:3346 7161#, no-c-format 7162msgid "" 7163"The environment variable <varname>KID3_CONFIG_FILE</varname> can be used to " 7164"set the path of the configuration file." 7165msgstr "" 7166 7167#. Tag: title 7168#: index.docbook:3354 7169#, no-c-format 7170msgid "&DBus; Interface" 7171msgstr "" 7172 7173#. Tag: title 7174#: index.docbook:3357 7175#, no-c-format 7176msgid "&DBus; Examples" 7177msgstr "" 7178 7179#. Tag: para 7180#: index.docbook:3359 7181#, no-c-format 7182msgid "" 7183"On &Linux; a &DBus;-interface can be used to control &kid3; by scripts. " 7184"Scripts can be written in any language with &DBus;-bindings (<abbrev>e.g.</" 7185"abbrev> in Python) and can be added to the <guilabel>User Actions</guilabel> " 7186"to extend the functionality of &kid3;." 7187msgstr "" 7188 7189#. Tag: para 7190#: index.docbook:3366 7191#, no-c-format 7192msgid "" 7193"The artist in tag 2 of the current file can be set to the value \"One Hit " 7194"Wonder\" with the following code:" 7195msgstr "" 7196 7197#. Tag: term 7198#: index.docbook:3372 7199#, no-c-format 7200msgid "Shell" 7201msgstr "" 7202 7203#. Tag: programlisting 7204#: index.docbook:3374 7205#, no-c-format 7206msgid "" 7207"dbus-send --dest=org.kde.kid3 --print-reply=literal \\\n" 7208"/Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \\\n" 7209"string:'One Hit Wonder'" 7210msgstr "" 7211 7212#. Tag: para 7213#: index.docbook:3375 7214#, no-c-format 7215msgid "" 7216"or easier with &Qt;'s <command>qdbus</command> (<command>qdbusviewer</" 7217"command> can be used to explore the interface in a &GUI;):" 7218msgstr "" 7219 7220#. Tag: programlisting 7221#: index.docbook:3379 7222#, no-c-format 7223msgid "" 7224"qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \\\n" 7225"'One Hit Wonder'" 7226msgstr "" 7227 7228#. Tag: term 7229#: index.docbook:3382 7230#, no-c-format 7231msgid "Python" 7232msgstr "" 7233 7234#. Tag: programlisting 7235#: index.docbook:3384 7236#, no-c-format 7237msgid "" 7238"import dbus\n" 7239"kid3 = dbus.SessionBus().get_object(\n" 7240" 'org.kde.kid3', '/Kid3')\n" 7241"kid3.setFrame(2, 'Artist', 'One Hit Wonder')" 7242msgstr "" 7243 7244#. Tag: term 7245#: index.docbook:3387 7246#, no-c-format 7247msgid "Perl" 7248msgstr "" 7249 7250#. Tag: programlisting 7251#: index.docbook:3389 7252#, no-c-format 7253msgid "" 7254"use Net::DBus;\n" 7255"$kid3 = Net::DBus->session->get_service(\n" 7256" \"org.kde.kid3\")->get_object(\n" 7257" \"/Kid3\", \"org.kde.Kid3\");\n" 7258"$kid3->setFrame(2, \"Artist\", \"One Hit Wonder\");" 7259msgstr "" 7260 7261#. Tag: title 7262#: index.docbook:3396 7263#, no-c-format 7264msgid "&DBus; API" 7265msgstr "" 7266 7267#. Tag: para 7268#: index.docbook:3398 7269#, no-c-format 7270msgid "" 7271"The &DBus; API is specified in <filename>org.kde.Kid3.xml</filename>. The " 7272"&kid3; interface has the following methods:" 7273msgstr "" 7274 7275#. Tag: title 7276#: index.docbook:3405 7277#, no-c-format 7278msgid "Open file or folder" 7279msgstr "" 7280 7281#. Tag: funcprototype 7282#: index.docbook:3407 7283#, no-c-format 7284msgid "" 7285"<funcdef>boolean <function>openDirectory</function></funcdef> " 7286"<paramdef>string <parameter>path</parameter></paramdef>" 7287msgstr "" 7288 7289#. Tag: replaceable 7290#: index.docbook:3414 index.docbook:3500 index.docbook:3610 index.docbook:3642 7291#: index.docbook:3660 7292#, no-c-format 7293msgid "path" 7294msgstr "" 7295 7296#. Tag: para 7297#: index.docbook:3415 7298#, no-c-format 7299msgid "path to file or folder" 7300msgstr "" 7301 7302#. Tag: para 7303#: index.docbook:3418 index.docbook:3439 index.docbook:3508 index.docbook:3618 7304#: index.docbook:3629 index.docbook:3904 index.docbook:4033 7305#, no-c-format 7306msgid "Returns true if OK." 7307msgstr "" 7308 7309#. Tag: title 7310#: index.docbook:3422 7311#, no-c-format 7312msgid "Unload the tags of all files which are not modified or selected" 7313msgstr "" 7314 7315#. Tag: function 7316#: index.docbook:3425 7317#, no-c-format 7318msgid "unloadAllTags" 7319msgstr "" 7320 7321#. Tag: title 7322#: index.docbook:3432 7323#, no-c-format 7324msgid "Save all modified files" 7325msgstr "" 7326 7327#. Tag: funcdef 7328#: index.docbook:3435 7329#, no-c-format 7330msgid "boolean <function>save</function>" 7331msgstr "" 7332 7333#. Tag: title 7334#: index.docbook:3443 7335#, no-c-format 7336msgid "Get a detailed error message provided by some methods" 7337msgstr "" 7338 7339#. Tag: funcdef 7340#: index.docbook:3446 7341#, no-c-format 7342msgid "string <function>getErrorMessage</function>" 7343msgstr "" 7344 7345#. Tag: para 7346#: index.docbook:3450 7347#, no-c-format 7348msgid "Returns detailed error message." 7349msgstr "" 7350 7351#. Tag: title 7352#: index.docbook:3454 7353#, no-c-format 7354msgid "Revert changes in the selected files" 7355msgstr "" 7356 7357#. Tag: function 7358#: index.docbook:3457 7359#, no-c-format 7360msgid "<function>revert</function>" 7361msgstr "" 7362 7363#. Tag: title 7364#: index.docbook:3464 7365#, no-c-format 7366msgid "Start an automatic batch import" 7367msgstr "" 7368 7369#. Tag: funcprototype 7370#: index.docbook:3466 7371#, no-c-format 7372msgid "" 7373"<funcdef>boolean <function>batchImport</function></funcdef> <paramdef>int32 " 7374"<parameter>tagMask</parameter></paramdef> <paramdef>string " 7375"<parameter>profileName</parameter></paramdef>" 7376msgstr "" 7377 7378#. Tag: replaceable 7379#: index.docbook:3474 index.docbook:3496 index.docbook:3523 index.docbook:3550 7380#: index.docbook:3606 index.docbook:3834 index.docbook:3860 index.docbook:3972 7381#: index.docbook:3989 index.docbook:4016 index.docbook:4046 index.docbook:4077 7382#: index.docbook:4093 index.docbook:4109 index.docbook:4125 index.docbook:4141 7383#, no-c-format 7384msgid "tagMask" 7385msgstr "" 7386 7387#. Tag: para 7388#: index.docbook:3475 index.docbook:3835 index.docbook:3861 7389#, no-c-format 7390msgid "tag mask (bit 0 for tag 1, bit 1 for tag 2)" 7391msgstr "" 7392 7393#. Tag: replaceable 7394#: index.docbook:3478 7395#, no-c-format 7396msgid "profileName" 7397msgstr "" 7398 7399#. Tag: para 7400#: index.docbook:3479 7401#, no-c-format 7402msgid "name of batch import profile to use" 7403msgstr "" 7404 7405#. Tag: title 7406#: index.docbook:3485 7407#, no-c-format 7408msgid "Import tags from a file" 7409msgstr "" 7410 7411#. Tag: funcprototype 7412#: index.docbook:3487 7413#, no-c-format 7414msgid "" 7415"<funcdef>boolean <function>importFromFile</function></funcdef> " 7416"<paramdef>int32 <parameter>tagMask</parameter></paramdef> <paramdef>string " 7417"<parameter>path</parameter></paramdef> <paramdef>int32 <parameter>fmtIdx</" 7418"parameter></paramdef>" 7419msgstr "" 7420 7421#. Tag: para 7422#: index.docbook:3497 index.docbook:3524 index.docbook:3551 index.docbook:3607 7423#: index.docbook:3973 index.docbook:3990 index.docbook:4017 index.docbook:4047 7424#: index.docbook:4078 index.docbook:4094 index.docbook:4110 index.docbook:4126 7425#: index.docbook:4142 7426#, no-c-format 7427msgid "tag bit (1 for tag 1, 2 for tag 2)" 7428msgstr "" 7429 7430#. Tag: para 7431#: index.docbook:3501 index.docbook:3611 7432#, no-c-format 7433msgid "path of file" 7434msgstr "" 7435 7436#. Tag: replaceable 7437#: index.docbook:3504 index.docbook:3614 7438#, no-c-format 7439msgid "fmtIdx" 7440msgstr "" 7441 7442#. Tag: para 7443#: index.docbook:3505 index.docbook:3615 7444#, no-c-format 7445msgid "index of format" 7446msgstr "" 7447 7448#. Tag: title 7449#: index.docbook:3512 7450#, no-c-format 7451msgid "Import tags from other tags" 7452msgstr "" 7453 7454#. Tag: funcprototype 7455#: index.docbook:3514 7456#, no-c-format 7457msgid "" 7458"<funcdef><function>importFromTags</function></funcdef> <paramdef>int32 " 7459"<parameter>tagMask</parameter></paramdef> <paramdef>string " 7460"<parameter>source</parameter></paramdef> <paramdef>string " 7461"<parameter>extraction</parameter></paramdef>" 7462msgstr "" 7463 7464#. Tag: replaceable 7465#: index.docbook:3527 index.docbook:3554 7466#, no-c-format 7467msgid "source" 7468msgstr "" 7469 7470#. Tag: para 7471#: index.docbook:3528 index.docbook:3555 7472#, no-c-format 7473msgid "format to get source text from tags" 7474msgstr "" 7475 7476#. Tag: replaceable 7477#: index.docbook:3531 index.docbook:3558 7478#, no-c-format 7479msgid "extraction" 7480msgstr "" 7481 7482#. Tag: para 7483#: index.docbook:3532 index.docbook:3559 7484#, no-c-format 7485msgid "" 7486"regular expression with frame names and captures to extract from source text" 7487msgstr "" 7488 7489#. Tag: title 7490#: index.docbook:3539 7491#, no-c-format 7492msgid "Import tags from other tags on selected files" 7493msgstr "" 7494 7495#. Tag: funcprototype 7496#: index.docbook:3541 7497#, no-c-format 7498msgid "" 7499"<funcdef>array <function>importFromTagsToSelection</function></funcdef> " 7500"<paramdef>int32 <parameter>tagMask</parameter></paramdef> <paramdef>string " 7501"<parameter>source</parameter></paramdef> <paramdef>string " 7502"<parameter>extraction</parameter></paramdef>" 7503msgstr "" 7504 7505#. Tag: replaceable 7506#: index.docbook:3565 7507#, no-c-format 7508msgid "returnValues" 7509msgstr "" 7510 7511#. Tag: para 7512#: index.docbook:3566 7513#, no-c-format 7514msgid "extracted value for \"%{__return}(.+)\"" 7515msgstr "" 7516 7517#. Tag: title 7518#: index.docbook:3572 7519#, no-c-format 7520msgid "Download album cover art" 7521msgstr "" 7522 7523#. Tag: funcprototype 7524#: index.docbook:3574 7525#, no-c-format 7526msgid "" 7527"<funcdef><function>downloadAlbumArt</function></funcdef> <paramdef>string " 7528"<parameter>url</parameter></paramdef> <paramdef>boolean " 7529"<parameter>allFilesInDir</parameter></paramdef>" 7530msgstr "" 7531 7532#. Tag: replaceable 7533#: index.docbook:3582 7534#, no-c-format 7535msgid "<replaceable>url</replaceable>" 7536msgstr "" 7537 7538#. Tag: para 7539#: index.docbook:3583 7540#, no-c-format 7541msgid "&URL; of picture file or album art resource" 7542msgstr "" 7543 7544#. Tag: replaceable 7545#: index.docbook:3587 7546#, no-c-format 7547msgid "allFilesInDir" 7548msgstr "" 7549 7550#. Tag: para 7551#: index.docbook:3588 7552#, no-c-format 7553msgid "true to add the image to all files in the folder" 7554msgstr "" 7555 7556#. Tag: title 7557#: index.docbook:3595 7558#, no-c-format 7559msgid "Export tags to a file" 7560msgstr "" 7561 7562#. Tag: funcprototype 7563#: index.docbook:3597 7564#, no-c-format 7565msgid "" 7566"<funcdef>boolean <function>exportToFile</function></funcdef> <paramdef>int32 " 7567"<parameter>tagMask</parameter></paramdef> <paramdef>string <parameter>path</" 7568"parameter></paramdef> <paramdef>int32 <parameter>fmtIdx</parameter></" 7569"paramdef>" 7570msgstr "" 7571 7572#. Tag: title 7573#: index.docbook:3622 7574#, no-c-format 7575msgid "Create a playlist" 7576msgstr "" 7577 7578#. Tag: funcdef 7579#: index.docbook:3625 7580#, no-c-format 7581msgid "boolean <function>createPlaylist</function>" 7582msgstr "" 7583 7584#. Tag: title 7585#: index.docbook:3633 7586#, no-c-format 7587msgid "Get items of a playlist" 7588msgstr "" 7589 7590#. Tag: funcprototype 7591#: index.docbook:3635 7592#, no-c-format 7593msgid "" 7594"<funcdef>array <function>getPlaylistItems</function></funcdef> " 7595"<paramdef>string <parameter>path</parameter></paramdef>" 7596msgstr "" 7597 7598#. Tag: para 7599#: index.docbook:3643 index.docbook:3661 7600#, no-c-format 7601msgid "path to playlist file" 7602msgstr "" 7603 7604#. Tag: para 7605#: index.docbook:3646 7606#, no-c-format 7607msgid "Returns list of absolute paths to playlist items." 7608msgstr "" 7609 7610#. Tag: title 7611#: index.docbook:3650 7612#, no-c-format 7613msgid "Set items of a playlist" 7614msgstr "" 7615 7616#. Tag: funcprototype 7617#: index.docbook:3652 7618#, no-c-format 7619msgid "" 7620"<funcdef>boolean <function>setPlaylistItems</function></funcdef> " 7621"<paramdef>string <parameter>path</parameter></paramdef> <paramdef>array " 7622"<parameter>items</parameter></paramdef>" 7623msgstr "" 7624 7625#. Tag: replaceable 7626#: index.docbook:3664 7627#, no-c-format 7628msgid "items" 7629msgstr "" 7630 7631#. Tag: para 7632#: index.docbook:3665 7633#, no-c-format 7634msgid "list of absolute paths to playlist items" 7635msgstr "" 7636 7637#. Tag: para 7638#: index.docbook:3668 7639#, no-c-format 7640msgid "" 7641"Returns true if OK, false if not all items were found and added or saving " 7642"failed." 7643msgstr "" 7644 7645#. Tag: title 7646#: index.docbook:3673 7647#, no-c-format 7648msgid "Quit the application" 7649msgstr "" 7650 7651#. Tag: function 7652#: index.docbook:3676 7653#, no-c-format 7654msgid "quit" 7655msgstr "" 7656 7657#. Tag: title 7658#: index.docbook:3683 7659#, no-c-format 7660msgid "Select all files" 7661msgstr "" 7662 7663#. Tag: function 7664#: index.docbook:3686 7665#, no-c-format 7666msgid "selectAll" 7667msgstr "" 7668 7669#. Tag: title 7670#: index.docbook:3693 7671#, no-c-format 7672msgid "Deselect all files" 7673msgstr "" 7674 7675#. Tag: function 7676#: index.docbook:3696 7677#, no-c-format 7678msgid "deselectAll" 7679msgstr "" 7680 7681#. Tag: title 7682#: index.docbook:3703 7683#, no-c-format 7684msgid "Set the first file as the current file" 7685msgstr "" 7686 7687#. Tag: funcdef 7688#: index.docbook:3706 7689#, no-c-format 7690msgid "boolean <function>firstFile</function>" 7691msgstr "" 7692 7693#. Tag: para 7694#: index.docbook:3710 index.docbook:3743 7695#, no-c-format 7696msgid "Returns true if there is a first file." 7697msgstr "" 7698 7699#. Tag: title 7700#: index.docbook:3714 7701#, no-c-format 7702msgid "Set the previous file as the current file" 7703msgstr "" 7704 7705#. Tag: funcdef 7706#: index.docbook:3717 7707#, no-c-format 7708msgid "boolean <function>previousFile</function>" 7709msgstr "" 7710 7711#. Tag: para 7712#: index.docbook:3721 index.docbook:3754 7713#, no-c-format 7714msgid "Returns true if there is a previous file." 7715msgstr "" 7716 7717#. Tag: title 7718#: index.docbook:3725 7719#, no-c-format 7720msgid "Set the next file as the current file" 7721msgstr "" 7722 7723#. Tag: funcdef 7724#: index.docbook:3728 7725#, no-c-format 7726msgid "boolean <function>nextFile</function>" 7727msgstr "" 7728 7729#. Tag: para 7730#: index.docbook:3732 index.docbook:3765 7731#, no-c-format 7732msgid "Returns true if there is a next file." 7733msgstr "" 7734 7735#. Tag: title 7736#: index.docbook:3736 7737#, no-c-format 7738msgid "Select the first file" 7739msgstr "" 7740 7741#. Tag: funcdef 7742#: index.docbook:3739 7743#, no-c-format 7744msgid "boolean <function>selectFirstFile</function>" 7745msgstr "" 7746 7747#. Tag: title 7748#: index.docbook:3747 7749#, no-c-format 7750msgid "Select the previous file" 7751msgstr "" 7752 7753#. Tag: funcdef 7754#: index.docbook:3750 7755#, no-c-format 7756msgid "boolean <function>selectPreviousFile</function>" 7757msgstr "" 7758 7759#. Tag: title 7760#: index.docbook:3758 7761#, no-c-format 7762msgid "Select the next file" 7763msgstr "" 7764 7765#. Tag: funcdef 7766#: index.docbook:3761 7767#, no-c-format 7768msgid "boolean <function>selectNextFile</function>" 7769msgstr "" 7770 7771#. Tag: title 7772#: index.docbook:3769 7773#, no-c-format 7774msgid "Select the current file" 7775msgstr "" 7776 7777#. Tag: funcdef 7778#: index.docbook:3772 7779#, no-c-format 7780msgid "boolean <function>selectCurrentFile</function>" 7781msgstr "" 7782 7783#. Tag: para 7784#: index.docbook:3776 7785#, no-c-format 7786msgid "Returns true if there is a current file." 7787msgstr "" 7788 7789#. Tag: title 7790#: index.docbook:3780 7791#, no-c-format 7792msgid "Expand or collapse the current file item if it is a folder" 7793msgstr "" 7794 7795#. Tag: funcdef 7796#: index.docbook:3783 7797#, no-c-format 7798msgid "boolean <function>expandDirectory</function>" 7799msgstr "" 7800 7801#. Tag: para 7802#: index.docbook:3787 7803#, no-c-format 7804msgid "" 7805"A file list item is a folder if getFileName() returns a name with '/' as the " 7806"last character." 7807msgstr "" 7808 7809#. Tag: para 7810#: index.docbook:3789 7811#, no-c-format 7812msgid "Returns true if current file item is a folder." 7813msgstr "" 7814 7815#. Tag: title 7816#: index.docbook:3793 7817#, no-c-format 7818msgid "Apply the file name format" 7819msgstr "" 7820 7821#. Tag: function 7822#: index.docbook:3796 7823#, no-c-format 7824msgid "applyFilenameFormat" 7825msgstr "" 7826 7827#. Tag: title 7828#: index.docbook:3803 7829#, no-c-format 7830msgid "Apply the tag format" 7831msgstr "" 7832 7833#. Tag: function 7834#: index.docbook:3806 7835#, no-c-format 7836msgid "applyTagFormat" 7837msgstr "" 7838 7839#. Tag: function 7840#: index.docbook:3816 7841#, no-c-format 7842msgid "applyTextEncoding" 7843msgstr "" 7844 7845#. Tag: title 7846#: index.docbook:3823 7847#, no-c-format 7848msgid "Set the folder name from the tags" 7849msgstr "" 7850 7851#. Tag: funcprototype 7852#: index.docbook:3825 7853#, no-c-format 7854msgid "" 7855"<funcdef>boolean <function>setDirNameFromTag</function></funcdef> " 7856"<paramdef>int32 <parameter>tagMask</parameter></paramdef> <paramdef>string " 7857"<parameter>format</parameter></paramdef> <paramdef>boolean " 7858"<parameter>create</parameter></paramdef>" 7859msgstr "" 7860 7861#. Tag: replaceable 7862#: index.docbook:3838 index.docbook:3956 7863#, no-c-format 7864msgid "format" 7865msgstr "" 7866 7867#. Tag: para 7868#: index.docbook:3839 7869#, no-c-format 7870msgid "folder name format" 7871msgstr "" 7872 7873#. Tag: replaceable 7874#: index.docbook:3842 7875#, no-c-format 7876msgid "create" 7877msgstr "" 7878 7879#. Tag: para 7880#: index.docbook:3843 7881#, no-c-format 7882msgid "true to create, false to rename" 7883msgstr "" 7884 7885#. Tag: para 7886#: index.docbook:3846 7887#, no-c-format 7888msgid "" 7889"Returns true if OK, else the error message is available using " 7890"getErrorMessage()." 7891msgstr "" 7892 7893#. Tag: title 7894#: index.docbook:3850 7895#, no-c-format 7896msgid "Set subsequent track numbers in the selected files" 7897msgstr "" 7898 7899#. Tag: funcprototype 7900#: index.docbook:3852 7901#, no-c-format 7902msgid "" 7903"<funcdef><function>numberTracks</function></funcdef> <paramdef>int32 " 7904"<parameter>tagMask</parameter></paramdef> <paramdef>int32 " 7905"<parameter>firstTrackNr</parameter></paramdef>" 7906msgstr "" 7907 7908#. Tag: replaceable 7909#: index.docbook:3864 7910#, no-c-format 7911msgid "firstTrackNr" 7912msgstr "" 7913 7914#. Tag: para 7915#: index.docbook:3865 7916#, no-c-format 7917msgid "number to use for first file" 7918msgstr "" 7919 7920#. Tag: title 7921#: index.docbook:3871 7922#, no-c-format 7923msgid "Filter the files" 7924msgstr "" 7925 7926#. Tag: funcprototype 7927#: index.docbook:3873 7928#, no-c-format 7929msgid "" 7930"<funcdef><function>filter</function></funcdef> <paramdef>string " 7931"<parameter>expression</parameter></paramdef>" 7932msgstr "" 7933 7934#. Tag: replaceable 7935#: index.docbook:3880 7936#, no-c-format 7937msgid "expression" 7938msgstr "" 7939 7940#. Tag: para 7941#: index.docbook:3881 7942#, no-c-format 7943msgid "filter expression" 7944msgstr "" 7945 7946#. Tag: title 7947#: index.docbook:3887 7948#, no-c-format 7949msgid "Convert ID3v2.3 tags to ID3v2.4" 7950msgstr "" 7951 7952#. Tag: function 7953#: index.docbook:3890 7954#, no-c-format 7955msgid "convertToId3v24" 7956msgstr "" 7957 7958#. Tag: title 7959#: index.docbook:3897 7960#, no-c-format 7961msgid "Convert ID3v2.4 tags to ID3v2.3" 7962msgstr "" 7963 7964#. Tag: function 7965#: index.docbook:3900 7966#, no-c-format 7967msgid "convertToId3v23" 7968msgstr "" 7969 7970#. Tag: title 7971#: index.docbook:3908 7972#, no-c-format 7973msgid "Get path of folder" 7974msgstr "" 7975 7976#. Tag: funcdef 7977#: index.docbook:3911 7978#, no-c-format 7979msgid "string <function>getDirectoryName</function>" 7980msgstr "" 7981 7982#. Tag: para 7983#: index.docbook:3915 7984#, no-c-format 7985msgid "Returns absolute path of folder." 7986msgstr "" 7987 7988#. Tag: title 7989#: index.docbook:3919 7990#, no-c-format 7991msgid "Get name of current file" 7992msgstr "" 7993 7994#. Tag: funcdef 7995#: index.docbook:3922 7996#, no-c-format 7997msgid "string <function>getFileName</function>" 7998msgstr "" 7999 8000#. Tag: para 8001#: index.docbook:3926 8002#, no-c-format 8003msgid "Returns true absolute file name, ends with \"/\" if it is a folder." 8004msgstr "" 8005 8006#. Tag: title 8007#: index.docbook:3930 8008#, no-c-format 8009msgid "Set name of selected file" 8010msgstr "" 8011 8012#. Tag: funcprototype 8013#: index.docbook:3932 8014#, no-c-format 8015msgid "" 8016"<funcdef><function>setFileName</function></funcdef> <paramdef>string " 8017"<parameter>name</parameter></paramdef>" 8018msgstr "" 8019 8020#. Tag: replaceable 8021#: index.docbook:3939 index.docbook:3993 index.docbook:4020 8022#, no-c-format 8023msgid "name" 8024msgstr "" 8025 8026#. Tag: para 8027#: index.docbook:3940 8028#, no-c-format 8029msgid "file name" 8030msgstr "" 8031 8032#. Tag: para 8033#: index.docbook:3943 8034#, no-c-format 8035msgid "The file will be renamed when the folder is saved." 8036msgstr "" 8037 8038#. Tag: title 8039#: index.docbook:3947 8040#, no-c-format 8041msgid "Set format to use when setting the filename from the tags" 8042msgstr "" 8043 8044#. Tag: funcprototype 8045#: index.docbook:3949 8046#, no-c-format 8047msgid "" 8048"<funcdef><function>setFileNameFormat</function></funcdef> <paramdef>string " 8049"<parameter>format</parameter></paramdef>" 8050msgstr "" 8051 8052#. Tag: para 8053#: index.docbook:3957 8054#, no-c-format 8055msgid "file name format" 8056msgstr "" 8057 8058#. Tag: title 8059#: index.docbook:3963 8060#, no-c-format 8061msgid "Set the file names of the selected files from the tags" 8062msgstr "" 8063 8064#. Tag: funcprototype 8065#: index.docbook:3965 8066#, no-c-format 8067msgid "" 8068"<funcdef><function>setFileNameFromTag</function></funcdef> <paramdef>int32 " 8069"<parameter>tagMask</parameter></paramdef>" 8070msgstr "" 8071 8072#. Tag: title 8073#: index.docbook:3979 8074#, no-c-format 8075msgid "Get value of frame" 8076msgstr "" 8077 8078#. Tag: funcprototype 8079#: index.docbook:3981 8080#, no-c-format 8081msgid "" 8082"<funcdef>string <function>getFrame</function></funcdef> <paramdef>int32 " 8083"<parameter>tagMask</parameter></paramdef> <paramdef>string <parameter>name</" 8084"parameter></paramdef>" 8085msgstr "" 8086 8087#. Tag: para 8088#: index.docbook:3994 index.docbook:4021 8089#, no-c-format 8090msgid "name of frame (<abbrev>e.g.</abbrev> \"artist\")" 8091msgstr "" 8092 8093#. Tag: para 8094#: index.docbook:3997 8095#, no-c-format 8096msgid "" 8097"To get binary data like a picture, the name of a file to write can be added " 8098"after the <parameter>name</parameter>, <abbrev>e.g.</abbrev> \"Picture:/path/" 8099"to/file\". In the same way, synchronized lyrics can be exported, <abbrev>e.g." 8100"</abbrev> \"SYLT:/path/to/file\"." 8101msgstr "" 8102 8103#. Tag: para 8104#: index.docbook:4001 8105#, no-c-format 8106msgid "Returns value of frame." 8107msgstr "" 8108 8109#. Tag: title 8110#: index.docbook:4005 8111#, no-c-format 8112msgid "Set value of frame" 8113msgstr "" 8114 8115#. Tag: funcprototype 8116#: index.docbook:4007 8117#, no-c-format 8118msgid "" 8119"<funcdef>boolean <function>setFrame</function></funcdef> <paramdef>int32 " 8120"<parameter>tagMask</parameter></paramdef> <paramdef>string <parameter>name</" 8121"parameter></paramdef> <paramdef>string <parameter>value</parameter></" 8122"paramdef>" 8123msgstr "" 8124 8125#. Tag: replaceable 8126#: index.docbook:4024 8127#, no-c-format 8128msgid "value" 8129msgstr "" 8130 8131#. Tag: para 8132#: index.docbook:4025 8133#, no-c-format 8134msgid "value of frame" 8135msgstr "" 8136 8137#. Tag: para 8138#: index.docbook:4028 8139#, no-c-format 8140msgid "" 8141"For tag 2 (<parameter>tagMask</parameter> 2), if no frame with " 8142"<parameter>name</parameter> exists, a new frame is added, if " 8143"<parameter>value</parameter> is empty, the frame is deleted. To add binary " 8144"data like a picture, a file can be added after the <parameter>name</" 8145"parameter>, <abbrev>e.g.</abbrev> \"Picture:/path/to/file\". \"SYLT:/path/to/" 8146"file\" can be used to import synchronized lyrics." 8147msgstr "" 8148 8149#. Tag: title 8150#: index.docbook:4037 8151#, no-c-format 8152msgid "Get all frames of a tag" 8153msgstr "" 8154 8155#. Tag: funcprototype 8156#: index.docbook:4039 8157#, no-c-format 8158msgid "" 8159"<funcdef>array of string <function>getTag</function></funcdef> " 8160"<paramdef>int32 <parameter>tagMask</parameter></paramdef>" 8161msgstr "" 8162 8163#. Tag: para 8164#: index.docbook:4050 8165#, no-c-format 8166msgid "Returns list with alternating frame names and values." 8167msgstr "" 8168 8169#. Tag: title 8170#: index.docbook:4054 8171#, no-c-format 8172msgid "Get technical information about file" 8173msgstr "" 8174 8175#. Tag: funcdef 8176#: index.docbook:4057 8177#, no-c-format 8178msgid "array of string <function>getInformation</function>" 8179msgstr "" 8180 8181#. Tag: para 8182#: index.docbook:4061 8183#, no-c-format 8184msgid "" 8185"Properties are Format, Bitrate, Samplerate, Channels, Duration, Channel " 8186"Mode, VBR, Tag 1, Tag 2. Properties which are not available are omitted." 8187msgstr "" 8188 8189#. Tag: para 8190#: index.docbook:4064 8191#, no-c-format 8192msgid "Returns list with alternating property names and values." 8193msgstr "" 8194 8195#. Tag: title 8196#: index.docbook:4068 8197#, no-c-format 8198msgid "Set tag from file name" 8199msgstr "" 8200 8201#. Tag: funcprototype 8202#: index.docbook:4070 8203#, no-c-format 8204msgid "" 8205"<funcdef><function>setTagFromFileName</function></funcdef> <paramdef>int32 " 8206"<parameter>tagMask</parameter></paramdef>" 8207msgstr "" 8208 8209#. Tag: title 8210#: index.docbook:4084 8211#, no-c-format 8212msgid "Set tag from other tag" 8213msgstr "" 8214 8215#. Tag: funcprototype 8216#: index.docbook:4086 8217#, no-c-format 8218msgid "" 8219"<funcdef><function>setTagFromOtherTag</function></funcdef> <paramdef>int32 " 8220"<parameter>tagMask</parameter></paramdef>" 8221msgstr "" 8222 8223#. Tag: title 8224#: index.docbook:4100 8225#, no-c-format 8226msgid "Copy tag" 8227msgstr "" 8228 8229#. Tag: funcprototype 8230#: index.docbook:4102 8231#, no-c-format 8232msgid "" 8233"<funcdef><function>copyTag</function></funcdef> <paramdef>int32 " 8234"<parameter>tagMask</parameter></paramdef>" 8235msgstr "" 8236 8237#. Tag: title 8238#: index.docbook:4116 8239#, no-c-format 8240msgid "Paste tag" 8241msgstr "" 8242 8243#. Tag: funcprototype 8244#: index.docbook:4118 8245#, no-c-format 8246msgid "" 8247"<funcdef><function>pasteTag</function></funcdef> <paramdef>int32 " 8248"<parameter>tagMask</parameter></paramdef>" 8249msgstr "" 8250 8251#. Tag: title 8252#: index.docbook:4132 8253#, no-c-format 8254msgid "Remove tag" 8255msgstr "" 8256 8257#. Tag: funcprototype 8258#: index.docbook:4134 8259#, no-c-format 8260msgid "" 8261"<funcdef><function>removeTag</function></funcdef> <paramdef>int32 " 8262"<parameter>tagMask</parameter></paramdef>" 8263msgstr "" 8264 8265#. Tag: title 8266#: index.docbook:4148 8267#, no-c-format 8268msgid "Reparse the configuration" 8269msgstr "" 8270 8271#. Tag: function 8272#: index.docbook:4151 8273#, no-c-format 8274msgid "reparseConfiguration" 8275msgstr "" 8276 8277#. Tag: para 8278#: index.docbook:4155 8279#, no-c-format 8280msgid "" 8281"Automated configuration changes are possible by modifying the configuration " 8282"file and then reparsing the configuration." 8283msgstr "" 8284 8285#. Tag: title 8286#: index.docbook:4160 8287#, no-c-format 8288msgid "Plays the selected files" 8289msgstr "" 8290 8291#. Tag: function 8292#: index.docbook:4163 8293#, no-c-format 8294msgid "playAudio" 8295msgstr "" 8296 8297#. Tag: title 8298#: index.docbook:4174 8299#, no-c-format 8300msgid "QML Interface" 8301msgstr "" 8302 8303#. Tag: title 8304#: index.docbook:4177 8305#, no-c-format 8306msgid "QML Examples" 8307msgstr "" 8308 8309#. Tag: para 8310#: index.docbook:4179 8311#, no-c-format 8312msgid "" 8313"QML scripts can be invoked via the context menu of the file list and can be " 8314"set in the tab <link linkend=\"configure-user-actions-qml\">User Actions</" 8315"link> of the settings dialog. The scripts which are set there can be used as " 8316"examples to program custom scripts. QML uses &javascript;, here is the " 8317"obligatory \"Hello World\":" 8318msgstr "" 8319 8320#. Tag: programlisting 8321#: index.docbook:4187 8322#, no-c-format 8323msgid "" 8324"import Kid3 1.0\n" 8325"\n" 8326"Kid3Script {\n" 8327" onRun: {\n" 8328" console.log(\"Hello world, folder is\", app.dirName)\n" 8329" Qt.quit()\n" 8330" }\n" 8331"}" 8332msgstr "" 8333 8334#. Tag: para 8335#: index.docbook:4189 8336#, no-c-format 8337msgid "" 8338"If this script is saved as <filename>/path/to/Example.qml</filename>, the " 8339"user command can be defined as <command>@qml /path/to/Example.qml</command> " 8340"with name <userinput>QML Test</userinput> and <guilabel>Output</guilabel> " 8341"checked. It can then be started using the <guilabel>QML Test</guilabel> item " 8342"in the file list context menu, and the output will be visible in the window." 8343msgstr "" 8344 8345#. Tag: para 8346#: index.docbook:4198 8347#, no-c-format 8348msgid "" 8349"Alternatively, the script could also be started independent of &kid3; using " 8350"the QML tools. <screen width=\"80\">\n" 8351"qml -apptype widget -I /usr/lib/kid3/plugins/imports /path/to/Example.qml\n" 8352"</screen> or <screen width=\"80\">\n" 8353"qmlscene -I /usr/lib/kid3/plugins/imports /path/to/Example.qml\n" 8354"</screen> On &Windows; and &macOS;, the import path must be adapted to the " 8355"<filename class=\"directory\">imports</filename> folder inside the " 8356"installation folder. Scripts started outside of &kid3; will use the current " 8357"folder, so it should be changed beforehand." 8358msgstr "" 8359 8360#. Tag: para 8361#: index.docbook:4211 8362#, no-c-format 8363msgid "" 8364"To list the titles in the tags 2 of all files in the current folder, the " 8365"following script could be used:" 8366msgstr "" 8367 8368#. Tag: programlisting 8369#: index.docbook:4216 8370#, no-c-format 8371msgid "" 8372"import Kid3 1.0\n" 8373"\n" 8374"Kid3Script {\n" 8375" onRun: {\n" 8376" app.firstFile()\n" 8377" do {\n" 8378" if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {\n" 8379" console.log(app.getFrame(tagv2, \"title\"))\n" 8380" }\n" 8381" } while (app.nextFile())\n" 8382" }\n" 8383"}" 8384msgstr "" 8385 8386#. Tag: para 8387#: index.docbook:4218 8388#, no-c-format 8389msgid "" 8390"If the folder contains many files, such a script might block the user " 8391"interface for some time. For longer operations, it should therefore have a " 8392"break from time to time. The alternative implementation below has the work " 8393"for a single file moved out into a function. This function invokes itself " 8394"with a timeout of 1 ms at the end, given that more files have to be " 8395"processed. This will ensure that the &GUI; remains responsive while the " 8396"script is running." 8397msgstr "" 8398 8399#. Tag: programlisting 8400#: index.docbook:4227 8401#, no-c-format 8402msgid "" 8403"import Kid3 1.0\n" 8404"\n" 8405"Kid3Script {\n" 8406" onRun: {\n" 8407" function doWork() {\n" 8408" if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {\n" 8409" console.log(app.getFrame(tagv2, \"title\"))\n" 8410" }\n" 8411" if (!app.nextFile()) {\n" 8412" Qt.quit()\n" 8413" } else {\n" 8414" setTimeout(doWork, 1)\n" 8415" }\n" 8416" }\n" 8417"\n" 8418" app.firstFile()\n" 8419" doWork()\n" 8420" }\n" 8421"}" 8422msgstr "" 8423 8424#. Tag: para 8425#: index.docbook:4229 8426#, no-c-format 8427msgid "" 8428"When using <command>app.firstFile()</command> with <command>app.nextFile()</" 8429"command>, all files of the current folder will be processed. If only the " 8430"selected files shall be affected, use <command>firstFile()</command> and " 8431"<command>nextFile()</command> instead, these are convenience functions of " 8432"the <classname>Kid3Script</classname> component. The following example is a " 8433"script which copies only the disc number and copyright frames of the " 8434"selected file." 8435msgstr "" 8436 8437#. Tag: programlisting 8438#: index.docbook:4239 8439#, no-c-format 8440msgid "" 8441"import Kid3 1.1\n" 8442"\n" 8443"Kid3Script {\n" 8444" onRun: {\n" 8445" function doWork() {\n" 8446" if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {\n" 8447" app.setFrame(tagv2, \"*.selected\", false)\n" 8448" app.setFrame(tagv2, \"discnumber.selected\", true)\n" 8449" app.setFrame(tagv2, \"copyright.selected\", true)\n" 8450" app.copyTags(tagv2)\n" 8451" }\n" 8452" if (!nextFile()) {\n" 8453" Qt.quit()\n" 8454" } else {\n" 8455" setTimeout(doWork, 1)\n" 8456" }\n" 8457" }\n" 8458"\n" 8459" firstFile()\n" 8460" doWork()\n" 8461" }\n" 8462"}" 8463msgstr "" 8464 8465#. Tag: para 8466#: index.docbook:4241 8467#, no-c-format 8468msgid "" 8469"More example scripts come with &kid3; and are already registered as user " 8470"commands." 8471msgstr "" 8472 8473#. Tag: para 8474#: index.docbook:4245 8475#, no-c-format 8476msgid "" 8477"<guilabel>ReplayGain to SoundCheck</guilabel> " 8478"(<filename>ReplayGain2SoundCheck.qml</filename>): Create iTunNORM SoundCheck " 8479"information from replay gain frames." 8480msgstr "" 8481 8482#. Tag: para 8483#: index.docbook:4250 8484#, no-c-format 8485msgid "" 8486"<guilabel>Resize Album Art</guilabel> (<filename>ResizeAlbumArt.qml</" 8487"filename>): Resize embedded cover art images which are larger than 500x500 " 8488"pixels." 8489msgstr "" 8490 8491#. Tag: para 8492#: index.docbook:4255 8493#, no-c-format 8494msgid "" 8495"<guilabel>Extract Album Art</guilabel> (<filename>ExtractAlbumArt.qml</" 8496"filename>): Extract all embedded cover art pictures avoiding duplicates." 8497msgstr "" 8498 8499#. Tag: para 8500#: index.docbook:4260 8501#, no-c-format 8502msgid "" 8503"<guilabel>Embed Album Art</guilabel> (<filename>EmbedAlbumArt.qml</" 8504"filename>): Embed cover art found in image files into audio files in the " 8505"same folder." 8506msgstr "" 8507 8508#. Tag: para 8509#: index.docbook:4265 8510#, no-c-format 8511msgid "" 8512"<guilabel>Embed Lyrics</guilabel> (<filename>EmbedLyrics.qml</filename>): " 8513"Fetch unsynchronized lyrics from web service." 8514msgstr "" 8515 8516#. Tag: para 8517#: index.docbook:4270 8518#, no-c-format 8519msgid "" 8520"<guilabel>Text Encoding ID3v1</guilabel> (<filename>ShowTextEncodingV1.qml</" 8521"filename>): Helps to find the encoding of ID3v1 tags by showing the tags of " 8522"the current file in all available character encodings." 8523msgstr "" 8524 8525#. Tag: para 8526#: index.docbook:4276 8527#, no-c-format 8528msgid "" 8529"<guilabel>ID3v1 to ASCII</guilabel> (<filename>Tag1ToAscii.qml</filename>): " 8530"Transliterate extended latin characters in the ID3v1 tag to ASCII." 8531msgstr "" 8532 8533#. Tag: para 8534#: index.docbook:4281 8535#, no-c-format 8536msgid "" 8537"<guilabel>English Title Case</guilabel> (<filename>TitleCase.qml</" 8538"filename>): Formats text in the tags to English title case." 8539msgstr "" 8540 8541#. Tag: para 8542#: index.docbook:4286 8543#, no-c-format 8544msgid "" 8545"<guilabel>Rewrite Tags</guilabel> (<filename>RewriteTags.qml</filename>): " 8546"Rewrite all tags in the selected files." 8547msgstr "" 8548 8549#. Tag: para 8550#: index.docbook:4291 8551#, no-c-format 8552msgid "" 8553"<guilabel>Export CSV</guilabel> (<filename>ExportCsv.qml</filename>): Export " 8554"recursively all tags of all files to a CSV file." 8555msgstr "" 8556 8557#. Tag: para 8558#: index.docbook:4296 8559#, no-c-format 8560msgid "" 8561"<guilabel>Export Playlist Folder</guilabel> (<filename>ExportPlaylist.qml</" 8562"filename>): Copy all files from a playlist into a folder and rename them " 8563"according to their position." 8564msgstr "" 8565 8566#. Tag: para 8567#: index.docbook:4302 8568#, no-c-format 8569msgid "" 8570"<guilabel>QML Console</guilabel> (<filename>QmlConsole.qml</filename>): " 8571"Simple console to play with &kid3;'s QML API." 8572msgstr "" 8573 8574#. Tag: title 8575#: index.docbook:4313 8576#, no-c-format 8577msgid "QML API" 8578msgstr "" 8579 8580#. Tag: para 8581#: index.docbook:4315 8582#, no-c-format 8583msgid "" 8584"The API can be easily explored using the QML Console, which is available as " 8585"an example script with a user interface." 8586msgstr "" 8587 8588#. Tag: title 8589#: index.docbook:4321 8590#, no-c-format 8591msgid "Kid3Script" 8592msgstr "" 8593 8594#. Tag: para 8595#: index.docbook:4323 8596#, no-c-format 8597msgid "" 8598"<classname>Kid3Script</classname> is a regular QML component located inside " 8599"the plugin folder. You could use another QML component just as well. Using " 8600"<classname>Kid3Script</classname> makes it easy to start the script function " 8601"using the <function>onRun</function> signal handler. Moreover it offers some " 8602"functions:" 8603msgstr "" 8604 8605#. Tag: programlisting 8606#: index.docbook:4330 8607#, no-c-format 8608msgid "" 8609"onRun: Signal handler which is invoked when the script is started\n" 8610"tagv1, tagv2, tagv2v1: Constants for tag parameters\n" 8611"script: Access to scripting functions\n" 8612"configs: Access to configuration objects\n" 8613"getArguments(): List of script arguments\n" 8614"isStandalone(): true if the script was not started from within Kid3\n" 8615"setTimeout(callback, delay): Starts callback after delay ms\n" 8616"firstFile(): To first selected file\n" 8617"nextFile(): To next selected file" 8618msgstr "" 8619 8620#. Tag: title 8621#: index.docbook:4336 8622#, no-c-format 8623msgid "Scripting Functions" 8624msgstr "" 8625 8626#. Tag: para 8627#: index.docbook:4338 8628#, no-c-format 8629msgid "" 8630"As &javascript; and therefore QML too has only a limited set of functions " 8631"for scripting, the <function>script</function> object has some additional " 8632"methods, for instance:" 8633msgstr "" 8634 8635#. Tag: programlisting 8636#: index.docbook:4344 8637#, no-c-format 8638msgid "" 8639"script.properties(obj): String with Qt properties\n" 8640"script.writeFile(filePath, data): Write data to file, true if OK\n" 8641"script.readFile(filePath): Read data from file\n" 8642"script.removeFile(filePath): Delete file, true if OK\n" 8643"script.fileExists(filePath): true if file exists\n" 8644"script.fileIsWritable(filePath): true if file is writable\n" 8645"script.getFilePermissions(filePath): Get file permission mode bits\n" 8646"script.setFilePermissions(filePath, modeBits): Set file permission mode " 8647"bits\n" 8648"script.classifyFile(filePath): Get class of file (folder \"/\", symlink \"@" 8649"\", exe \"*\",\n" 8650" file \" \")\n" 8651"script.renameFile(oldName, newName): Rename file, true if OK\n" 8652"script.copyFile(source, dest): Copy file, true if OK\n" 8653"script.makeDir(path): Create folder, true if OK\n" 8654"script.removeDir(path): Remove folder, true if OK\n" 8655"script.tempPath(): Path to temporary folder\n" 8656"script.musicPath(): Path to music folder\n" 8657"script.listDir(path, [nameFilters], [classify]): List folder entries\n" 8658"script.system(program, [args], [msecs]): Synchronously start a system " 8659"command,\n" 8660" [exit code, standard output, standard error] if not timeout\n" 8661"script.systemAsync(program, [args], [callback]): Asynchronously start a " 8662"system\n" 8663"command, callback will be called with [exit code, standard output, standard\n" 8664"error]\n" 8665"script.getEnv(varName): Get value of environment variable\n" 8666"script.setEnv(varName, value): Set value of environment variable\n" 8667"script.getQtVersion(): Qt version string, <abbrev>e.g.</abbrev> \"5.4.1\"\n" 8668"script.getDataMd5(data): Get hex string of the MD5 hash of data\n" 8669"script.getDataSize(data): Get size of byte array\n" 8670"script.dataToImage(data, [format]): Create an image from data bytes\n" 8671"script.dataFromImage(img, [format]): Get data bytes from image\n" 8672"script.loadImage(filePath): Load an image from a file\n" 8673"script.saveImage(img, filePath, [format]): Save an image to a file, true if " 8674"OK\n" 8675"script.imageProperties(img): Get properties of an image, map containing\n" 8676" \"width\", \"height\", \"depth\" and \"colorCount\", empty if invalid " 8677"image\n" 8678"script.scaleImage(img, width, [height]): Scale an image, returns scaled image" 8679msgstr "" 8680 8681#. Tag: title 8682#: index.docbook:4349 8683#, no-c-format 8684msgid "Application Context" 8685msgstr "" 8686 8687#. Tag: para 8688#: index.docbook:4351 8689#, no-c-format 8690msgid "" 8691"Using QML, a large part of the &kid3; functions are accessible. The API is " 8692"similar to the one used for <link linkend=\"dbus-api\">&DBus;</link>. For " 8693"details, refer to the respective notes." 8694msgstr "" 8695 8696#. Tag: programlisting 8697#: index.docbook:4357 8698#, no-c-format 8699msgid "" 8700"app.openDirectory(path): Open folder\n" 8701"app.unloadAllTags(): Unload all tags\n" 8702"app.saveDirectory(): Save folder\n" 8703"app.revertFileModifications(): Revert\n" 8704"app.importTags(tag, path, fmtIdx): Import file\n" 8705"app.importFromTags(tag, source, extraction): Import from tags\n" 8706"app.importFromTagsToSelection(tag, source, extraction): Import from tags of " 8707"selected files\n" 8708"app.downloadImage(url, allFilesInDir): Download image\n" 8709"app.exportTags(tag, path, fmtIdx): Export file\n" 8710"app.writePlaylist(): Write playlist\n" 8711"app.getPlaylistItems(path): Get items of a playlist\n" 8712"app.setPlaylistItems(path, items): Set items of a playlist\n" 8713"app.selectAllFiles(): Select all\n" 8714"app.deselectAllFiles(): Deselect\n" 8715"app.firstFile([select], [onlyTaggedFiles]): To first file\n" 8716"app.nextFile([select], [onlyTaggedFiles]): To next file\n" 8717"app.previousFile([select], [onlyTaggedFiles]): To previous file\n" 8718"app.selectCurrentFile([select]): Select current file\n" 8719"app.selectFile(path, [select]): Select a specific file\n" 8720"app.getSelectedFilePaths([onlyTaggedFiles]): Get paths of selected files\n" 8721"app.requestExpandFileList(): Expand all\n" 8722"app.applyFilenameFormat(): Apply filename format\n" 8723"app.applyTagFormat(): Apply tag format\n" 8724"app.applyTextEncoding(): Apply text encoding\n" 8725"app.numberTracks(nr, total, tag, [options]): Number tracks\n" 8726"app.applyFilter(expr): Filter\n" 8727"app.convertToId3v23(): Convert ID3v2.4.0 to ID3v2.3.0\n" 8728"app.convertToId3v24(): Convert ID3v2.3.0 to ID3v2.4.0\n" 8729"app.getFilenameFromTags(tag): Filename from tags\n" 8730"app.getTagsFromFilename(tag): Filename to tags\n" 8731"app.getAllFrames(tag): Get object with all frames\n" 8732"app.getFrame(tag, name): Get frame\n" 8733"app.setFrame(tag, name, value): Set frame\n" 8734"app.getPictureData(): Get data from picture frame\n" 8735"app.setPictureData(data): Set data in picture frame\n" 8736"app.copyToOtherTag(tag): Tags to other tags\n" 8737"app.copyTags(tag): Copy\n" 8738"app.pasteTags(tag): Paste\n" 8739"app.removeTags(tag): Remove\n" 8740"app.playAudio(): Play\n" 8741"app.readConfig(): Read configuration\n" 8742"app.applyChangedConfiguration(): Apply configuration\n" 8743"app.dirName: Folder name\n" 8744"app.selectionInfo.fileName: File name\n" 8745"app.selectionInfo.filePath: Absolute file path\n" 8746"app.selectionInfo.detailInfo: Format details\n" 8747"app.selectionInfo.tag(Frame.Tag_1).tagFormat: Tag 1 format\n" 8748"app.selectionInfo.tag(Frame.Tag_2).tagFormat: Tag 2 format\n" 8749"app.selectionInfo.formatString(tag, format): Substitute codes in format " 8750"string\n" 8751"app.selectFileName(caption, dir, filter, saveFile): Open file dialog to\n" 8752"select a file\n" 8753"app.selectDirName(caption, dir): Open file dialog to select a folder" 8754msgstr "" 8755 8756#. Tag: para 8757#: index.docbook:4359 8758#, no-c-format 8759msgid "For asynchronous operations, callbacks can be connected to signals." 8760msgstr "" 8761 8762#. Tag: programlisting 8763#: index.docbook:4363 8764#, no-c-format 8765msgid "" 8766"function automaticImport(profile) {\n" 8767" function onAutomaticImportFinished() {\n" 8768" app.batchImporter.finished.disconnect(onAutomaticImportFinished)\n" 8769" }\n" 8770" app.batchImporter.finished.connect(onAutomaticImportFinished)\n" 8771" app.batchImport(profile, tagv2)\n" 8772"}\n" 8773"\n" 8774"function renameDirectory(format) {\n" 8775" function onRenameActionsScheduled() {\n" 8776" app.renameActionsScheduled.disconnect(onRenameActionsScheduled)\n" 8777" app.performRenameActions()\n" 8778" }\n" 8779" app.renameActionsScheduled.connect(onRenameActionsScheduled)\n" 8780" app.renameDirectory(tagv2v1, format, false)\n" 8781"}" 8782msgstr "" 8783 8784#. Tag: title 8785#: index.docbook:4368 8786#, no-c-format 8787msgid "Configuration Objects" 8788msgstr "" 8789 8790#. Tag: para 8791#: index.docbook:4370 8792#, no-c-format 8793msgid "" 8794"The different configuration sections are accessible via methods of " 8795"<function>configs</function>. Their properties can be listed in the QML " 8796"console. <screen width=\"80\">\n" 8797"script.properties(configs.networkConfig())\n" 8798"</screen> Properties can be set:" 8799msgstr "" 8800 8801#. Tag: screen 8802#: index.docbook:4377 8803#, no-c-format 8804msgid "configs.networkConfig().useProxy = false" 8805msgstr "" 8806 8807#. Tag: programlisting 8808#: index.docbook:4380 8809#, no-c-format 8810msgid "" 8811"configs.batchImportConfig()\n" 8812"configs.exportConfig()\n" 8813"configs.fileConfig()\n" 8814"configs.filenameFormatConfig()\n" 8815"configs.filterConfig()\n" 8816"configs.findReplaceConfig()\n" 8817"configs.guiConfig()\n" 8818"configs.importConfig()\n" 8819"configs.mainWindowConfig()\n" 8820"configs.networkConfig()\n" 8821"configs.numberTracksConfig()\n" 8822"configs.playlistConfig()\n" 8823"configs.renDirConfig()\n" 8824"configs.tagConfig()\n" 8825"configs.tagFormatConfig()\n" 8826"configs.userActionsConfig()" 8827msgstr "" 8828
