-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathhelp.html
33 lines (33 loc) · 10.7 KB
/
help.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN" "http://www.w3.org/Math/DTD/mathml2/xhtml-math11-f.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><!--This file was converted to xhtml by LibreOffice - see http://cgit.freedesktop.org/libreoffice/core/tree/filter/source/xslt for the code.--><head profile="http://dublincore.org/documents/dcmi-terms/"><meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8"/><title xml:lang="en-US">- no title specified</title><meta name="DCTERMS.title" content="" xml:lang="en-US"/><meta name="DCTERMS.language" content="en-US" scheme="DCTERMS.RFC4646"/><meta name="DCTERMS.source" content="http://xml.openoffice.org/odf2xhtml"/><meta name="DCTERMS.issued" content="2015-01-16T15:19:35.542251495" scheme="DCTERMS.W3CDTF"/><meta name="DCTERMS.modified" content="2015-02-08T12:31:11.934099761" scheme="DCTERMS.W3CDTF"/><meta name="DCTERMS.provenance" content="" xml:lang="en-US"/><meta name="DCTERMS.subject" content="," xml:lang="en-US"/><link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" hreflang="en"/><link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" hreflang="en"/><link rel="schema.DCTYPE" href="http://purl.org/dc/dcmitype/" hreflang="en"/><link rel="schema.DCAM" href="http://purl.org/dc/dcam/" hreflang="en"/><style type="text/css">
@page { }
table { border-collapse:collapse; border-spacing:0; empty-cells:show }
td, th { vertical-align:top; font-size:12pt;}
h1, h2, h3, h4, h5, h6 { clear:both }
ol, ul { margin:0; padding:0;}
li { list-style: none; margin:0; padding:0;}
<!-- "li span.odfLiEnd" - IE 7 issue-->
li span. { clear: both; line-height:0; width:0; height:0; margin:0; padding:0; }
span.footnodeNumber { padding-right:1em; }
span.annotation_style_by_filter { font-size:95%; font-family:Arial; background-color:#fff000; margin:0; border:0; padding:0; }
* { margin:0;}
.Heading_20_2 { font-size:115%; margin-bottom:0.212cm; margin-top:0.353cm; font-family:Liberation Sans; writing-mode:page; font-weight:bold; }
.P1 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P10 { font-size:12pt; line-height:120%; margin-bottom:0.247cm; margin-top:0cm; font-family:Arial; writing-mode:page; }
.P11 { font-size:12pt; line-height:120%; margin-bottom:0.247cm; margin-top:0cm; font-family:Arial; writing-mode:page; }
.P12 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P2 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P3 { font-size:12pt; font-family:Arial; writing-mode:page; font-weight:bold; }
.P4 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P5 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P6 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P7 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P8 { font-size:12pt; font-family:Arial; writing-mode:page; }
.P9 { font-size:12pt; font-family:Arial; writing-mode:page; }
.Text { font-size:12pt; font-style:italic; margin-bottom:0.212cm; margin-top:0.212cm; font-family:Arial; writing-mode:page; }
.Text_20_body { font-size:12pt; font-family:Arial; writing-mode:page; margin-top:0cm; margin-bottom:0.247cm; line-height:120%; }
.Title { font-size:28pt; margin-bottom:0.212cm; margin-top:0.423cm; font-family:Liberation Sans; writing-mode:page; text-align:center ! important; font-weight:bold; }
.Bullet_20_Symbols { font-family:OpenSymbol; }
<!-- ODF styles with no properties representable as CSS -->
.T1 .T2 .T3 .T4 .T5 .T6 .T7 .T8 .T9 { }
</style></head><body dir="ltr" style="max-width:21.001cm;margin-top:2cm; margin-bottom:2cm; margin-left:2cm; margin-right:2cm; writing-mode:lr-tb; "><p class="Title">FLAC Tagger</p><p class="P1">Author: Eggert Ehmke</p><p class="P1"><a href="mailto:[email protected]">[email protected]</a></p><p class="P1"> </p><p class="P1">Program: flactag.py <span class="T2">version 0.1.6</span></p><p class="P8">Source is available at: <a href="https://github.com/eehmke/flactag/">https://github.com/eehmke/flactag/</a></p><p class="P1"> </p><p class="P1">This program is <span class="T6">in alpha state</span> and may destroy your FLAC files. </p><p class="P3">Use at your own risk!</p><p class="P1">Be sure to have backup copies of your files. Only work on the copy. </p><p class="P1">You have been warned. If you loose any files or damage <span class="T4">your</span> Pono, the author will not be responsible for the loss.</p><p class="P1"> </p><p class="P1">This being said, the program seems to do it's job and has caused no harm on my system. Please test it and report your experiences to me. Error reports or feature suggestions are welcome.</p><h2 class="Heading_20_2"><a id="a__General_operation"><span/></a>General operation</h2><p class="P1">Flactag can be used to check, modify, <span class="T6">add</span> <span class="T1">or delete</span> the tags in a FLAC file. It has been written with the Pono specific enhancements in mind, but is not restricted to them. In this sense it is aimed to grow into a full featured tag editor. <span class="T2">However, it does not check the validity of entered tags. It allows to delete or modify of valid existing tags that may be important. It allows to add tags that may have no meaning.</span></p><p class="P1"> </p><p class="P9">Display and changing of cover art pictures is supported. Only the front cover can be displayed and changed! Other pictures will be deleted, if present.</p><p class="P1"> </p><p class="P1">The Pono specific tags are <span class="T6">'</span>phc<span class="T6">'</span> and <span class="T6">'</span>release_guid<span class="T6">'</span>. It is not checked if the file is actually a high resolution file. If you apply these tags to FLAC files that you ripped from CD, it will <span class="T3">nevertheless</span> switch the blue light on. <span class="T1">If you don't want to light the blue led, flactag can be used to delete these tags.</span></p><p class="P1"> </p><p class="P6">A color icon will appear to indicate the hires state. <span class="T6">The color code is evaluated as follows:</span></p><ul><li><p class="P12" style="margin-left:0cm;"><span class="Bullet_20_Symbols" style="display:block;float:left;min-width:0,635cm;">•</span>16/44, phc not set: yellow<span class="odfLiEnd"/> </p></li><li><p class="P12" style="margin-left:0cm;"><span class="Bullet_20_Symbols" style="display:block;float:left;min-width:0,635cm;">•</span>16/44, phc set: red this is a warning as it makes no sense<span class="odfLiEnd"/> </p></li><li><p class="P12" style="margin-left:0cm;"><span class="Bullet_20_Symbols" style="display:block;float:left;min-width:0,635cm;">•</span>>16/44, phc not set green<span class="odfLiEnd"/> </p></li><li><p class="P12" style="margin-left:0cm;"><span class="Bullet_20_Symbols" style="display:block;float:left;min-width:0,635cm;">•</span>>16/44, phc set blue as the blue LED on the Pono :-)<span class="odfLiEnd"/> </p></li></ul><p class="P1"> </p><p class="P2">To add these tags to a FLAC file, <span class="T7">select the file and </span>press the Button „Add Hires Tag<span class="T2">s</span>“. If there is no release_guid tag, it will be created <span class="T2">as a random string</span>. If there is already one release_guid tag, it will be used. If the calculation of the key results is a valid Pono signature, a warning will be displayed. If all checks are done, the phc tag will be calculated and added to the list of tags.</p><p class="P2"> </p><p class="P2">The actual file will not be written until the user selects „Save File“ from the File menu. If the file has been modified and a new file is opened, or if the program is about to close, a warning will be displayed.</p><p class="P1"> </p><p class="P5">To add or remove hires tags to a complete directory tree, select that directory and select the context menu by pressing the right mouse button. Select „Set Pono tags in this directory“ or „Reset Pono tags in this directory“. The action will be applied for all files in that directory and its subdirectory. <span class="T5">Only files that have a sample rate above 44100 Hz are modified.</span></p><h2 class="Heading_20_2"><a id="a__Batch_mode"><span/></a>Batch mode</h2><p class="P7">The program has some command line options that can be used to speed up the operation without using the graphical user interface (GUI). Users familiar with the command line interface (CLI) of their operating system may want to use this.</p><p class="P7"> </p><p class="P7">To start the program, run command </p><p class="Text">flactag.py</p><p class="Text_20_body">The comm<span class="T7">and accepts these options:</span></p><p class="P10">flactag.py -h<span> </span><span> </span><span> show a short help text</span></p><p class="P10">flactag.py -b -d <dir><span> run in batch mode and show the content of directory <dir></span></p><p class="P10">flactag.py -b -s -d <dir><span> run in batch mode and set the phc to all hires files in that direcory, including subdirectories. The number of modified files will be displayed</span></p><p class="P10">flactag.py -b -r -d <dir><span> run in batch mode and reset the phc to all files in that direcory, including subdirectories. The number of modified files will be displayed</span></p><p class="P10">All commands can be <span class="T8">run with the -v (--verbose) option. In this case detailed debug messages will be displayed that can be used for analysis of problems.</span></p><h2 class="Heading_20_2"><a id="a__Licensing"><span/></a>Licensing</h2><p class="P11">This program is free software <span class="T9">(see below)</span>, everyone can copy and modify it for his/her purpose. If you create a branch of the github project, send me a pull request. If you find this program usefull, you are free to send me some donation so I can buy me a beer or two. Cheers!</p><p class="P11">PayPal account: [email protected]</p><p class="P4">Have fun and enjoy the blue light</p><p class="P4">Eggert</p><p class="P1"> </p><p class="P1"> </p><p class="P9">This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p><p class="P9"> </p><p class="P9">This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p><p class="P9"> </p><p class="P9">You should have received a copy of the GNU General Public License along with this program. If not, see <a href="http://www.gnu.org/licenses">http://www.gnu.org/licenses</a>. </p></body></html>