ProfileTagger ------------- In order to use the ProfileTagger you need a configuration file, namely TaggerPresets.txt. The easiest and most comfortable (as well as the recommended) way to create, respectively change such a file is with the GUI version on either Mac or PC and to copy the resulting TaggerPresets.txt. Some settings can be specified both on the command line and in the configuration file, eg. "--writereport" (command line) is equivalent to "WritePDFReport" (configuration file). Mac OS X: The configuration file TaggerPresets.txt can be found in ~/Library/Preferences/ Windows: The configuration file TaggerPresets.txt can be found in the according APPDATA directory, usually C:\Documents and Settings\\Application Data Unix: An example file with common configurations can be found in ~/.ColorLogic/TaggerPresets.txt or /usr/share/profiletagger/TaggerPresets.txt. Please note that changing the /usr/share/profiletagger/TaggerPresets.txt won't affect the available configurations, since it is to be seen as just an example file upon which you can create your own TaggerPresets.txt. Changing the original file in /usr/share/profiletagger/ is actually heavily discouraged. ICC profiles are expected to be stored in the folders specified by the OpenICC directory proposal; i.e. ProfileTagger will search for profiles in /var/lib/color/icc/, /usr/share/color/icc/, /usr/local/share/color/icc (if existant) and ~/.local/share/icc. ProfileTagger also creates a directory ~/Profiles where profiles can be stored (and which of course will also be searched for profiles). Profiles that are used as arguments for command line options are usually specified by their file name only, without the full path. Configuration options in TaggerPresets.txt: ------------------------------------------- Example: uniqueidentifier = { Name = "Tag Profiles - Europe" UseCase = "Replace Tagged Profiles" Profiles = { 0 = ISOnewspaper26v4.icc 1 = CoatedFOGRA27.icc 2 = CoatedFOGRA39.icc 3 = ISOcoated.icc 4 = ISOcoated_v2_300_eci.icc 5 = WebCoatedFOGRA28.icc 6 = ISOcoated_v2_eci.icc 7 = ISOuncoated.icc 8 = ISOuncoatedyellowish.icc 9 = ISOwebcoated.icc 10 = SC_paper_eci.icc 11 = UncoatedFOGRA29.icc } MinQuality = 50 MinAbsImprovement = 1 MinRelImprovement = 25 AddAnnotations = 0 AnalyzeMode = 0 DefaultProfile = ISOcoated_v2_eci.icc UseOutputIntent = true Mode = 1 ReadOnly = 1 IsEdited = 0 WritePDFReport = true } Options: Name: The name of the configuration, the same name must be specified on the command line. Profiles: List of ICC profiles to check for. MinQuality, MinAbsImprovement, MinRelImprovement: Parameters profile replacements. These provide a finer control over profile replacement than with the "Mode" option only, but we recommend to not change these values and better use them as they are: Mode = 0 --> MinQuality = 0.0, MinAbsImprovement = 0.5, MinRelImprovement = 0.0 Mode = 1 --> MinQuality = 50.0, MinAbsImprovement = 1.0, MinRelImprovement = 25.0 Mode = 2 --> MinQuality = 100.0, MinAbsImprovement = 1.0, MinRelImprovement = 1.0 Mode = 3 --> MinQuality = -1.0, MinAbsImprovement = 1.0, MinRelImprovement = 25.0 AddAnnotations: 1: Add annotations into PDF file. 0: Don't add annotations into PDF file. AnalyzeMode: 1: Analyze only. 0: Analyze and tag/replace profiles. DefaultProfile: Use specified file as default profile (or output intent) UseOutputIntent: true: If the file contains an output intent, use that instead of the profile specified as DefaultProfile. false: Ignore output intent. Mode: Profile replacement mode. 0: Always use better profiles. 1: Only use significantly better profiles 2: Don't replace tagged profiles 3: Ignore tagged profiles WritePDFReport: true - Generate PDF report. false - Don't generate PDF report. Command Line: ------------- ProfileTagger [options] input [-o output]... Options: --configuration Loads the specified configuration from TaggerPresets.txt. Note that in order to use the program, this option together with configurations from TaggerPresets.txt is everything you really need. --listconfigurations Output list of available configurations to stdout. --progress: Print progress messages (percent) to stdout. --reportfile=filename: Define file for PDF report. If not specified, a default name is chosen dependent on the name of the input file. --listdefaultprofiles: output list of default profiles to stdout Print a list of profiles suitable as default profiles (or output intents), actually CMYK printer profiles. --listprofiles: Print a list of profiles suitable for analyzing/tagging, actually CMYK printer profiles. The following options have equivalents in the configuration. --writereport=yes/no: See "WritePDFReport" --analyzeonly=yes/no: See "AnalyzeMode" --defaultprofile=filename: See "DefaultProfile" --useoutputintent=yes/no: See "Use OutputIntent" --annotations=yes/no: See "AddAnnotations" --mode=0/1/2/3: See "Mode" --profile=filename: Add specified profile to profile list to check for.