Frequently Asked Questions
Can I submit new/revised data files?
Absolutely! Almost all of the current data content of GCS was provided by helpful individuals other than
me. If you have completely new content, please create a new library for it and send the resulting file.
If, on the other hand, you're modifying one of the existing data files, please be sure to update to the
latest version from the git repository first, make your changes, then submit a patch file of the
differences. In either case, please either create a
Pull Request or an
Issue for the work and attach
the new file or patch file to that.
What page reference abbreviations are being used in the data files?
The current list of page reference abbreviations can be found here:
How do I get GCS to use a high DPI display without pixelation/blurring when run on Windows?
In the Windows Explorer:
- Right-click the GCS app icon and choose "Properties"
- Select the "Compatibility" tab
- Click the "Change high DPI settings" button
- Check the checkbox at the bottom labeled "Override high DPI scaling behavior"
- Change the combo to say "Application" if it doesn't already
I've chosen a dark theme on Linux and it is making GCS unusable. How do I fix this?
This is discussed here:
Is there a version of GCS localized for my language?
The short answer is no. However, if you'd like to provide a translation for a language you're fluent in,
copy the template.i18n file in the i18n
directory and name it for your language (e.g. de.i18n for German), then
edit its contents, updating the v: values to have the translation for the
k: values. If you have questions, feel free to contact me about this.
Where can I find the global preferences file?
Its location is dependent upon your specific platform. You can find the preference file here:
- macOS: ~/Library/Preferences/gcs.json
- Windows: %LOCALAPPDATA%\gcs.json
- Linux: ~/.config/gcs.json
Does GCS produce a log file?
Yes. Its location is dependent upon your specific platform and some environment variables (see the next
question about environment variables). By default, you can find the log file here:
- macOS: ~/Library/Logs/gcs.log
- Windows: %LOCALAPPDATA%\logs\gcs.log
- Linux: ~/.local/logs/gcs.log
Are there any environment variables for controlling GCS's behavior? If so, what are they?
As of the v4.21 release, there are only two (not counting standard system ones, such as
HOME on macOS and Linux and LOCALAPPDATA on
- GCS_LOG: Sets the file that GCS will log problems to. This file is
overwritten with each launch. See "Does GCS produce a log file" above for details on where the log
file gets written if this environment variable is not set.
- GCS_TRANSLATIONS: Sets the directory that GCS will load
language translations from. By default, the i18n directory
inside the application package is used.