You can find here a brief (but hopefully sufficient) guide for configuring phex "behind-the-scenes".
Most configuration values can be changed via the GUI, but some cannot: some values are potentially too dangerous to expose new users to, others should (almost) never be changed, and some should have a GUI entry but we haven't got around to it yet. :-)
Reading: When phex starts it first sets all configuration values to "safe" defaults, then reads the phexCorePrefs.properties and overwrites the default values. This means you can delete phexCorePrefs.properties if things are getting too messy. It also means you can safely delete individual lines, knowing that default values will be used.
Writing: Whenever configuration values are changed, and when phex ends, the configuration file is overwritten. This implies 2 things: don't try to edit phexCorePrefs.properties while phex is running, and don't be surprised when new configuration values appear in your config after an upgrade. (In theory some values may also disappear, if they're not used by the later version)
Editing lists: A few configuration settings are lists. The first element's name ends in _1, the second in _2, etc. These can be edited as usual, but be aware that if phex will stop processing the list as soon as one name isn't found. ie: if _2 is missing, _3, _4, etc. will be ignored.
Regular expressions and delimiters: A couple of entries use regular expressions. These are powerful, but if you don't know what you're doing you may get into a mess. In addition, java requires backslashes to be escaped. See below for an example.
| Name | Description | Example |
|---|---|---|
| initialSegmentSize | When a candidate is first contacted a segment of this size (in bytes) will be requested | initialSegmentSize=16384 |
| segmentTransferTime | When a candidate is ready for a further segment, the maximum size of the segment is that which would have been downloaded in this time frame, based on the previous segment's download rate. e.g. if the previous segment was downloaded at 10k/sec and segmentTransferTime=60, the next segment would be no larger than 600k. | segmentTransferTime=100 |
| maximumSegmentSize | No segment will be larger than this, no matter how quickly the previous segment was downloaded | maximumSegmentSize=999999 |
| Name | Description | Example |
|---|---|---|
| orderingMethod | Ordering method to use if the file is streamable, unstreamable or unknown, respectively. In this example, streamable files are ordered in preview mode (3), other files are sorted by rating (2). See the Specifications/Rating.htm file for more information about the methods. | orderingMethod=322 |
| streamableSuffixes | A list of file suffixes which are to be considered streamable. Case is ignored. Both examples here use regular expressions: the first example matches "htm" and "html", the second matches both "mp2" and "mp3" | streamableSuffixes_1=html? streamableSuffixes_2=mp\\d |
| unstreamableSuffixes | A list of file suffixes which are to be considered unstreamable. Similar to above. | unstreamableSuffixes_1=rar unstreamableSuffixes_2=r\\d\\d |
| copyBeforePreviewing | Whether phex should copy the segment and before attempting to execute the viewer | copyBeforePreviewing=true |
| previewMethod | A map of file suffixes to previewers. If a file matches the suffix, the previewer is
invoked. The string %s is substituted with the filename.
%u is substituted with the URL referring to the file.
More than one suffix can be given: see the 4th example below. This uses the gimp for GIF, JPEG and JPG files. |
previewMethod_mp\\d=/usr/local/bin/mplayer %s previewMethod_ogg=/usr/local/bin/oggplay %s previewMethod_html?=/usr/bin/firefox %u previewMethod_(gif|jpe?g)=gimp %s |
| fallbackPreviewMethod | Preview method to use when no specific previewer is associated with this suffix. WARNING: the following example is a potential security breach on windows! This will have the same effect as double-clicking on the file. If you preview a batch file, for example, you will actually execute it, potentially damaging your system. Proceed with caution, and consider yourself warned. | fallbackPreviewMethod=cmd /c %s |