The configuration file is where the API key and download location inputted during installation gets saved. It also has a couple other settings as well.
On Windows, the configuration file can be found here:
C:\Program Files (x86)\Cirrus Forecast\Cirrus Forecast Downloader\config\settings.ini
Here is an example of what the settings.ini
file contains.
[General]
LibraryVersion=1.0.0
[Settings]
ApiKey=a0123456789z_abcdefghijklmnopqrstuvwxyz
DownloadDirectory=C:\Users\automation\Desktop\cirrus_forecast_files
[Logging]
Level=normal
Category | Option | Description |
---|---|---|
General |
LibraryVersion |
This is the current version of the Cirrus Forecast Downloader you are running. Note: This is for informational purposes and shouldn't be changed. |
Settings |
ApiKey |
Your API key from the "API Keys" page |
Settings |
DownloadDirectory |
The directory to download the weather forecast audio files. |
Logging |
Level |
This is how detailed the logs that the Cirrus Forecast Downloader creates should be. It can either be normal (default value) or debug . |
If you need to update your API key or the download path, you can change it in the configuration file and re-save it. After re-saving it, you will need to restart the Windows Service so it picks up the changes.
The ApiKey
can be found on the "API Keys" page here. To get a new API key, click "Add new API key".
{warning} Generating a new API key overwrites the old one. If you already have the downloader running, it will stop working until the API key is updated with the newly generated one.
Note: In order to keep your API key secure, you cannot retrieve a previously generated API key once you leave the "API Keys" page after generating a new one. You can, however, re-generate a key as many times as you need to. Because of this, it is advised to NOT record or write the key somewhere other than this configuration file.
To edit the file, right-click on it and click "Edit". This will open Notepad. Once the changes are made, go to File -> Save
.
{info} If you get an error trying to save the
settings.ini
file or a "Save as..." window comes up, you don't have permission to edit the file. To get around this, copy the file to your Desktop, make the changes, and then drag-and-drop the file back toC:\Program Files (x86)\Cirrus Forecast\Cirrus Forecast Downloader\config\
Steps to restart the Windows Service
services
or services.msc
in the Start Menu and open