PGGB is a PCM remastering tool for upsampling or downsampling PCM audio files with an optimal choice of linear filters. PGGB also transfers all the common meta data tags to the converted files. PGGB always saves the converted files in .wav format. Image and cover information within the metadata are transferred when possible. All PCM rates including DXD are supported. PGGB will convert DSD to PCM too with an optimal choice of linear filter.
PGGB will process all files in the input folder and all folders in the input folders recursively. For example, if you have a music folder 'C:\Music' and the folder contains albums organized in multiple folders like C:\Music\Album-1, C:\Music\Album-2. It will process any music file with extensions (.wav, .flac ,aif, .aiif, .m4a, .dsf) in both C:\Music and also the Album-1 and Album-2 folders. The upsampled files will be found in output directory and they will be organized in the same way in sub-folders. PGGB also copies jpg, png and pdf files to the destination folders.
It is very simple to use. Once you have chosen the input and output folders (both are required), press ‘Process’ to start processing. Use Pause to pause processing and ‘Stop’ to stop processing. Stop and Pause may take a few seconds to a few minutes depending on what PGGB is processing. Once the processing has started, you may also add new folders inside the input folder. PGGB will discover them and will process them too after it has competed the current set of folders. Processing can be done in three modes. Selecting ‘Create New’ will create a new album folder if the album already exists in the output directory. ‘Skip’ will skip previously processed tracks if they are present in the output folder and ‘Overwrite’ will overwrite existing tracks. You may add multiple input folders using the ‘Add’ button, you may also remove an input folder by selecting it and pressing ‘Remove’.
Advanced: If PGGB finds 'pggb_to_process.txt' in the input folder, it will process the list of folders in the text file (recursively), in addition to any folders in the input folder. By default, it will create a folder with the name of the parent folder. If it finds ‘FQN’ in the first line of the text file, it will replicate the full directory structure (Excluding the drive letter) in the output folder.
On Windows, The very first time PGGB runs it may request permission for firewall. Please accept the request as PGGB needs it to manage parallel threads and in the case of a trial license, it needs to connect to a time server.
PGGB is already tuned to provide optimal results with very little tweaking needed. In short it is in auto-pilot mode. Go to ‘configure’ tab to change the settings.
Settings for the three dropdowns on the left are determined by your DAC and your PC
- Output Sample Rate: Choose a sample-rate family that matches the maximum output rate supported by your DAC.
- Maximum Taps: PGGB will choose the maximum taps to use for upsampling based on the physical memory on your PC. It is best to leave it as is.
- Output Bit Depth: If your DAC supports 32 bits, then 32 bits is the best option. If you wish to do further processing (such as EQ or dither), then 64 bit doubles may be a good option too but do be aware, it will double the storage requirements. If your DAC is a 24 bit DAC, dithering or noise shaping is recommended to reduce correlated quantization noise. Bit depths of 12 bits through 32 are an available to help you choose the right bit depth that is optimal for your DAC. For example, some R2R DACs may have a higher settling time for very high sample rates (1Mhz or more), in these cases, choosing lower bit depths may help.
- Adaptive Noise Shaping: PGGB will choose the optimal noise shaping algorithm to remove quantization noise from audible range if left in ‘Auto’ or ‘On’. Noise shaping helps attain high small signal accuracy in the audible range. The algorithm is based on the bit depth, sample rate you have chosen, and noise filter settings. The noise shaping and is very effective in removing quantization noise. Removal of quantization noise results in a very life like sound. Choose ‘None’ if you do not want any noise shaping (not recommended).
- Gain (dB): If you wish to use PGGB for off-line volume control, you may set the gain. Also refer Inter-Sample-Overs Section.
Settings on the right (three sets of buttons) can be chosen based on your preferences, though the default settings should work best for the majority.
Transparency Setting: These two buttons helps you choose between two flavors of transparency. Both provide a very high time domain reconstruction accuracy but make different tradeoffs. What you choose may depend on your playback chain and preferences.
- Natural: This is the default setting; it is the most natural presentation that portrays leading edges and timing accurately while maintaining body and warmth.
- Front Row: This setting is a different take compared to above. It is a slightly forward presentation favoring micro-detail, giving the feeling of a ‘front row seat’.
Presentation: PGGB is already optimized to provide maximum transparency, depth, and timbre. The presentation buttons let you fine-tune time domain characteristics of the remastered music and strike a balance between transparency and dense presentation. Choose ‘Moderate’ or ‘Dense’ when you need more body. This is especially useful for genres such as classic rock, big band jazz or CDs that may not have the best downsampled quality.
Noise filter: It is common for higher samplerate material to have a significant out of band quantization noise; this is especially true with DXD and DSD, but listening test and analysis show even material at 88.1kHz and above can benefit from noise filtering. Beyond the audible range, there reaches a point where it becomes increasingly hard to differentiate between quantization and other noise and the music signal. This is can be recording dependent and makes it harder to choose the noise filter. The new noise filter used in PGGB tries to simplify and remove some of the guess work. The default setting (Moderate) would work best in most cases. This is all about balancing the signal to noise ratio at frequencies beyond the audible range. As more filtering is done (Full setting), the sound is cleaner but may sound smoother or a little less open. With less filtering (Minimal setting), it would sound airy but can come at the cost of added noise or harshness. The Moderate setting seems to strike the right balance where it remains clean and yet has enough air and detail without starting to sound edgy. These are still very subtle changes to help you fine tune to your system and preferences. There is no correct answer. The noise filter will not be applied to 44.1k or 48k material.
Apodizing: CD audio can often have aliasing distortion due to either deficiencies in the decimation filters used or the Analog to digital conversion process. Apodizing is recommended to remove these aliasing distortions during the remastering process.
Load or Save Settings
If you own multiple DACS or if you wish to process your library with different settings, you can create multiple settings. To create new settings, enter the name of the setting you wish to create and press save. To overwrite existing setting, select the setting from the drop-down, make the setting changes and press save. You can also remove existing settings; just choose the setting you wish to remove and press Remove.
Note: Default setting cannot be removed but can be overwritten.
PGGB uses the longest possible tap count depending on track length. However, depending on how the tracks were indexed, it is possible that some albums (especially long classical works) may have been cut into multiple tracks even though they were a single long recording. In these cases, to take advantage of longer tap lengths that would have been available had the tracks not been cut, PGGB allows you to treat contiguous group of tracks as one. Please be aware that PGGB currently does not split the tracks back to the original track numbering after processing. To allow PGGB to combine tracks, you will need to create a 'combine.json' file and drop it into the album folder. You will have to provide the tracks you want to combine as a comma separated list within quotes, enclosed in ''. In the below example, tracks 2-7 will be combined and given a track number '2' and tracks 7-14 will be combined and given a track number '7'. The rest of the tracks will be processed normally.For Combine to work, there are a few requirements
- The sets of tracks being combined cannot have overlaps
- The tracks should have the track numbers in their meta data
The status window at the bottom provides useful information about the current state of PGGB. This includes error messages, displays values when you change a setting, the current file it is processing etc. When PGGB is processing files, the status window may be a bit slow to refresh. This is normal. PGGB also displays detailed messages in a command window and logs them too. Progress bars show batch, Album and track level progress.
The output is log file can be found by typing ‘%HOMEPATH%\PGGB’ in windows explorer address bar. Album level logs can be found in remastered output folders. . On Mac Go to Home(cmd-shift-H)\PGGB.
Between PGGB and Your DAC
Digital processing within PGGB has been done with the utmost care. When playing back PGGB remastered tracks, a bit perfect transmission to your DAC will yield the best results and when possible, your DAC must be configured to do the least processing.
Setting up your DAC:
- A direct connection (or the equivalent) to your DAC from the end point is ideal (i.e., not using any upsamplers).
Use of re-clockers or regens that do not alter the bits are OK
- Set PGGB output rate to the maximum input PCM rate your DAC supports.
- Set PGGB output bit depth to the native bit depth of your DAC (not the maximum allowed by the Audio driver). In the
case of some R2R DACs, the optimal bit depth may depend on the sample rate.
- If your DAC has the option, set your DAC to NOS mode.
Your playback software:
Any playback software you use should not do any processing of the PGGB remastered tracks. This includes volume control, dither, noise shaping, further upsampling, bit depth conversion (padding is OK). I.e., PGGB remastered tracks should be transmitted to your DAC bit for bit without any change for the best results.
A note about software volume control:
Software volume control may look innocuous, what possible harm could come from converting to 64 bit doubles and changing the level? PGGB’s noise shaper all but eliminates quantization noise in the audible range. Any sort of processing such as volume control leads to 64 bit conversion and then truncation back to your DAC’s bit depth (16, 24 or 32). This conversion adds quantization noise back into the track that PGGB worked hard to remove.
Sometimes your DAC does not provide volume control and/or you may prefer to use software volume control. You have couple of choices:
- Best option: Set PGGB to Remaster output as 64bit, the downside is large file size. Use software volume control and output at desired bit-depth. Enable Noise shaping if or dither if your playback software supports it
- Alternate option: Disable noise shaping in PGGB and output in 32 bit format. Use software volume control and output at desired bit-depth. Enable Noise shaping or dither if your playback software supports it
- Another option (use with caution): This is a good option if you do not use the volume knob much and generally leave it at a fixed level (like say -3dB). Enable noise shaping in PGGB, and set the gain slider to the reduced gain (same as what you would set in your player such as HQP) and gargle-blast your tracks. During playback, disable noise shaping or dither in your playback back software but start with a reduced level (first set the volume to where you will normally set it in your player) and gradually bring it up to 0dB or max.
Folder Paths and Permissions
Please make sure you have Read permission to the input folder and read/write permission to the output folder. In addition to this, PGGB needs write permission to:
- The APPDATA folder. PGGB installs the license and also saves the configuration in this folder. Typically, this is C:\Users\[user name]\AppData\Roaming\PGGB or you can access it by typing %appdata%\PGGB in windows explorer address bar.
- The HOMEPATH folder. PGGB writes logs into this folder in addition to writing logs into output folder. Typically, this is C:\Users\[user name]\PGGB or you can access it by typing %homepath%\PGGB in windows explorer address bar.
- PGGB installs the license and also saves the configuration in /Users/[user name]/PGGB
- PGGB writes logs (in addition to writing logs into output folder) to /Users/[user name]/PGGB
PGGB requires 64-bit Windows 10 PC or Mac (Mojave or higher). On Windows, 64GB RAM and 8 core processor is recommended. If your library is mostly 44.1kHz, a minimum 16GB (512M taps max) or 32GB RAM for more flexibility and a 4-core processor is required. On Mac, 16GB (512M taps max) with 4 cores will suffice for Redbook. On Windows, SSD drive for virtual memory (minimum of 128GB) is recommended too. Fast drives (SSD, NVMe, etc.) for input and output folder improve processing performance further. PGGB is memory intensive and would need virtual memory. Virtual memory on fast drives improve processing speed.
PGGB scales to use all the processor cores when more memory is available and CPU load can reach max TDP. Be sure that your PC has the cooling necessary to handle the heat especially if you have overclocked or run in turbo mode.
It is possible to run PGGB on Linux either within a virtual machine running Windows with the enough RAM and CPU cores allotted for the VM.
Note: PGGB requires Internet access during installation. It also needs Internet access for the trial version. On the first run, PGGB will request firewall permission to enable parallel processing. PGGB is mostly harmless, we do not use or share your personal information nor do we use the idle CPU cycles to mine Ethereum.
Virtual Memory (Windows only)
It is best to set the virtual memory (both the initial size and the maximum size) to the same value and equal.
128 GB or more is recommended. Choose the fastest internal drive for setting the virtual memory. Make sure the drive has
free space greater than the virtual memory size you set. For all other dries set 'No paging file'.
Restart your PC once you have set the virtual memory. After restart, check if the drive you set
virtual memory for has a 'pagefile.sys' file with the size close to the virtual memory size.
Note 1: Please make sure you have free space that is comfortably greater than the the virtual memory you allocated on the drive.
Note 2: Windows optimization programs such as Audiophile Optimizer or Process Lasso will interfere with the normal operation of PGGB. Please make sure programs that could throttle paging, memory and CPU usage are either deactivated or uninstalled.
To set virtual memory, use the system property command-let. Go to start menu and start typing ‘advanced’ and select "View Advanced System Settings." Then click Advanced-> Performance Settings. This will open the Performance Options dialog. Click on Advanced tab, then click the ‘Change’ button under ‘Virtual memory’. Finally, in the Virtual memory dialog, uncheck ‘automatically manage paging file’ and enter a value greater than 128000 under Maximum size in Mb. Virtual memory availability and drives are system dependent. Below is just one example.
PGGB requires a license and PGGB license is tied to your Hardware ID. You will also need to provide your name and email address to get a PGGB license. Your Hardware ID will be displayed if go to the ‘About’ tab. Use 'Ctrl + C' or 'Cmd + C' to copy your Hardware Id and paste it in the email. Refer here to get a license.
When PGGB does not find a valid license, it displays a ‘License’ button. Once you have a valid license, use the ‘License’ button to browse to the license file. Once the license is installed, it displays your name and the duration of the license (either perpetual or with a time limit). Hardware-id is tied to the PC you run it on. The license is non-transferable. When your Hardware-id changes, you may request for a new license. PGGB is not for commercial use unless you have purchased a commercial license
If you need to reinstall the license or you have upgraded your license, use the ‘I’ button next to ‘License’ to do so.
Hidden Menu (#42)
You can activate the hidden menu by using the key combination ‘Ctrl+4’, you can exit the hidden menu by using the key combination ‘Ctrl+2’. If the keys do not work, just click on the cocktail picture to reveal the hidden menu. The hidden menu provides five options:
- Logging: Choose the level of logging you prefer, with -2 being near silent to 2 that is extremely chatty.
- Workers: PGGB improves processing speeds by distributing the workload over multiple worker threads. It uses a heuristic based on the available RAM and logical cores to choose the optimal number of worker threads for each track. However, there are other factors (such as heat dissipation and fan noise) that PGGB is not aware. Here, you may use your judgment to cap the maximum number of worker threads. By default, this is the number of logical cores. If you set it to 1 there is no parallism and it may be beneficial to choose this option on a resource constrained PC for processing 176.4k or higher tracks including DXD and DSDs.
- Mode: PGGB can run under two modes
- Processing: PGGB processes and upsamples files, this is the default mode.
- Analysis: PGGB does no processing but instead prints statistics on how the tracks will be processed.
Note: PGGB remembers all your current settings on the next start, except the processing mode. This is intentional as you may forget the processing mode was set to analysis.
During reconstruction of the music signal after upsampling, the new samples can have values greater than 1.0 these are generally referred to as inter-sample-overs. Inter-sample overs will cause clipping and can be unpleasant.
When gain is set to Auto as shown above, PGGB detects inter-sample overs and applies just enough attenuation to avoid clipping. However, PGGB does this based on only the first block of data (about first 20 minutes in a track). If you are a fan of classical music, you already know tracks can be longer than 20 minutes. Since PGGB does not go back and reprocess tracks, when PGGB finds inter-sample overs, it records the value in pggb_album_analysis_vN.csv
pggb_album_analysis_vN.csv file is created for each album you process, inside the output folder of that album. This file has a log of useful information about each track such as the settings you used to process it, how long it took to process, number of Taps used etc. in addition to the settings information, it also has two columns (shown above, the rest are hidden here for clarity). On rare occasions where you suspect clipping of an upsampled track, you can refer this file, and look to see if First-block-gain matches the Track-gain. If not, there are portions of that track where clipping could occur. To fix this, you will need to either process the whole album or just track by using the gain shown under ‘Track-gain’. If you choose to process the whole album, be sure to choose the largest negative value under ‘Track-gain’ across all tracks in the album.
Workflow to Arrive at a Favorite Setting
PGGB is designed keep the interface intuitive. It tries to provide enough options to help you arrive at the optimal settings for your playback without overwhelming you with too many choices and combinations. Here is a simple workflow that may help you get started. The trick is to only change one setting at a time. Click on the ‘Onboarding’ tab and our paranoid robot Marvin will walk you through on how to arrive at your favorite. Please refer Marvin’s onboarding guide for more information. You may also press ‘Help’ link on the ‘Onboarding’ tab to access the onboarding guide.
This SOFTWARE PRODUCT is provided by THE PROVIDER "as is" and "with all faults." THE PROVIDER makes no representations or warranties of any kind concerning the safety, suitability, lack of viruses, inaccuracies, typographical errors, or other harmful components of this SOFTWARE PRODUCT. There are inherent dangers in the use of any software, and you are solely responsible for determining whether this SOFTWARE PRODUCT is compatible with your equipment and other software installed on your equipment. You are also solely responsible for the protection of your equipment and backup of your data, and THE PROVIDER will not be liable for any damages you may suffer in connection with using, modifying, or distributing this SOFTWARE PRODUCT.