By editing the
skcc_skimmer.cfg
configuration
file, you can customize how
SKCC
Skimmer
filters RBN spots and
Sked Page logins. The configurable items are described below.
5.1 MY_CALLSIGN
Set this to your callsign. Once you set it here, you won't need to
specify it on the command line.
1 |
2 |
3 |
|
|
MY_CALLSIGN = 'X6XXX' |
|
|
|
MY_CALLSIGN Example
5.2 ADI_FILE
This specifies the ADI file that contains a log of all SKCC stations
that you've every worked. This file is only read by
SKCC
Skimmer
, never written.
It is intended to be your live, active ADI file.
SKCC
Skimmer
will automatically re-read the contents of your ADI file
when it changes. In other words, when you make a new contact and your
logging program writes to it. Use any name you like. You can even
use a full path including backslashes (
\
) in Windows pathnames. Note that
the small '
r
' before the string is important. Do not remove it.
1 |
2 |
3 |
|
|
ADI_FILE = r'MasterLog.adi' |
|
|
|
ADI_FILE Example
5.3 MY_GRIDSQUARE
This should be set to the 6 character Grid Square of your QTH (or wherever
you are operating from). You can find your Grid Square by going to the
QRZ.com website and looking up your callsign. Go the
Detail
tab and look for "Grid Square". Enter this value in the
MY_GRIDSQUARE
configuration item (inside the quotation marks).
1 |
2 |
3 |
|
|
MY_GRIDSQUARE = 'DM33xh' |
|
|
|
MY_GRIDSQUARE Example
5.4 SPOTTER_RADIUS
SKCC
Skimmer
will only report spots close to your QTH. This item
specifies how close the spotter must be in order to be considered nearby.
1 |
2 |
3 |
|
|
SPOTTER_RADIUS = 800 |
|
|
|
SPOTTER_RADIUS Example
The perfect radius value
will depend on your QTH and the density of surrounding spotters. For example,
in Phoenix, there are not many nearby spotters, so a radius of about 800 miles will
include only about 10 spotters. Whereas on the east coast, the same radius value
yields more than 20 spotters. The spotters selected are displayed at startup so that
you can see the effect of your radius value. You'll
have to play with this value to strike the right balance for your QTH.
5.5 GOALS
SKCC
Skimmer
filters spots based on goals.
Goals
tell
SKCC
Skimmer
which SKCC award levels you're are trying
to achieve so that it can display RBN spots for stations that YOU NEED in order
to achieve those awards.
Targets tell
SKCC
Skimmer
which SKCC award levels you are trying to
help others achieve.
SKCC
Skimmer
will show you RBN spots for stations
that NEED YOU.
Valid
GOAL designations:
- K3Y - This goal helps you maximize your station and band yield during the K3Y
special event held each January. (See details here.)
- C - You are attempting to achieve Centurion status. If you are
already a Centurion, this goal will have no effect.
- T - You are attempting to achieve Tribune status. If you are
already a Tribune, this goal will have no effect.
- S - You are attempting to achieve Senator status. If you are
already a Senator, this goal will have no effect.
- CXN - You are attempting to achieve an advanced C award level. That is,
Cx2, Cx3, etc., all the way up to Cx10.
- TXN - You are attempting to achieve an advanced T award level. That is,
Tx2, Tx3, etc., all the way up to Tx10.
- SXN - You are attempting to achieve an advanced S award level. That is,
Sx2, Sx3, etc., all the way up to Sx10.
- P - The prefix award promotes contacting new members — the newer
the better. For example. Let's say you've worked a member with
prefix
AA4
whose member number
is 5000
, so you now have 5000
prefix points. Then, let's say you later work
another AA4
station whose
member number is 12000
. The higher member number now replaces the older station in your total
prefix point count, so now you have 12000
total prefix points. SKCC
Skimmer
will show you stations
that will advance your prefix point count; either because it's a brand new prefix for you, or because
that station has a higher member number than any member with that prefix that you've worked in the past.
Examples of spots that include prefix hits:
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
|
|
CONNECTED to K7MJG (skimmer.k7mjg.com:60001)... |
|
|
|
===== SKCC Sked Page ================= |
|
0353Z OK1UKV (10671 Jara CZE), YOU need them for Px4(new +10671), STATUS: 7.120 |
|
====================================== |
|
|
|
0354Z W7LXN (13049 Myron AZ) on 10115.0 by WZ7I(122mi, 17dB), YOU need them for Px4(+2192) |
|
|
|
Prefix spot examples
Note the prefix notation Px4(new +10671)
on line 5. SKCC
Skimmer
will tell you that you need a station in order
to advance your prefix point count. SKCC
Skimmer
will also tell you whether this is a
new prefix for you by displaying the word new
. If it's not new, then you have worked
a station with that prefix before but working this particular station will increase your point count by the indicated
amount.
- WAS - You are attempting to achieve the SKCC Worked All States
award.
SKCC
Skimmer
will show you spotted stations in states that you need to work towards that
goal.
- WAS-C - You are attempting to achieve the SKCC Centurion Worked All States
award.
SKCC
Skimmer
will show you spotted stations in states that you need to work towards that
goal.
- BRAG - Shows you spots and Sked page
logins that you have not yet worked this month towards your
monthly brag activity. Does not count QSOs worked during any
Sprint and will not show you brag RBN spots during any
Sprint.
- ALL - Enables all of the above.
- NONE - Turns off all goals.
Multiple goals are specified comma separated.
5.6 TARGETS
SKCC
Skimmer
filters spots based on targets.
Goals
tell
SKCC
Skimmer
which SKCC award levels you're are trying
to achieve so that it can display RBN spots for stations that YOU NEED in order
to achieve those awards.
Targets tell
SKCC
Skimmer
which SKCC award levels you are trying to
help others achieve.
SKCC
Skimmer
will show you RBN spots for stations
that NEED YOU.
Valid
TARGET designations:
- C - You are wanting to help others achieve their Centurion status.
- T - You are wanting to help others achieve their Tribune status.
- S - You are wanting to help others achieve their Senator status.
- CXN - You are wanting to help others achieve an advanced C award level. That is,
Cx2, Cx3, etc., all the way up to Cx10.
- TXN - You are wanting to help others achieve an advanced T award level. That is,
Tx2, Tx3, etc., all the way up to Tx10.
- SXN - You are wanting to help others achieve an advanced S award level. That is,
Sx2, Sx3, etc., all the way up to Sx10.
- ALL - Enables all of the above.
- NONE - Turns off all targets.
5.7 BANDS
Specifies which bands to monitor. Possible values are:
160, 80, 60, 40, 30, 20, 17, 15, 12, 10 and 6. There is
a commented out template line below the actual configuration
line to assist and remind you of all bands.
Spaces are okay in your configuration in order for it
to line up with the template.
1 |
2 |
3 |
4 |
|
|
BANDS = ' 40 20 10 ' |
|
# '160 80 60 40 30 20 17 15 12 10 6' (Template) |
|
|
|
BANDS Example
5.8 BRAG_MONTHS
Optional. Commands
SKCC
Skimmer
to display a history of brag results
at program startup. An arbitrary
number of months can be specified. Can be overridden from the command
line with the
--brag-months
option.
5.9 SPOT_PERSISTENCE_MINUTES
When an operator is logged in to the SKCC Sked Page and then also
issues a CQ that is spotted nearby,
SKCC
Skimmer
will display
a "last spotted" message indicating on what frequency the operator was last
spotted and how long ago.
SPOT_PERSISTENCE_MINUTES
indicates
how long that "last spotted" message persists before being removed.
If
SPOT_PERSISTENCE_MINUTES
is not specified in the configuration
file, the default is
15
minutes.
1 |
2 |
3 |
|
|
SPOT_PERSISTENCE_MINUTES = 10 |
|
|
|
SPOT_PERSISTENCE_MINUTES Example
5.10 EXCLUSIONS
A space separated list of callsigns to ignore. Good for specifying
beacons, for example.
EXCLUSIONS
overrides
FRIENDS
.
1 |
2 |
3 |
|
|
EXCLUSIONS = 'W1AW' |
|
|
|
EXCLUSIONS Example
5.11 FRIENDS
A space separated list of callsigns that are "friends" that have
some special significance. If the spotted callsign is in this list
of friends, then the spot will be displayed.
One member, a Senator, reports that they use the
FRIENDS
configuration
to list all existing Senators so that they can work the unofficial "Worked All Senators"
award.
5.12 PROGRESS_DOTS
If your criteria are very selective or you have worked a lot of stations,
you may have long periods
of time with no output. By enabling this option, you can
specify how many progress dots are displayed. If the option
is disabled, then no progress dots will be displayed.
- ENABLED -
True
if you want to see progress dots,
False
if you don't.
- DISPLAY_SECONDS - The number of seconds of silence
before a progress
dot is generated.
- DOTS_PER_LINE - Rather than having dots wrap around at the edge of the screen, you
can control how many dots are displayed on a line before a
new line is generated.
1 |
2 |
3 |
4 |
5 |
6 |
7 |
|
|
PROGRESS_DOTS = { |
|
'ENABLED' : True, |
|
'DISPLAY_SECONDS': 5, |
|
'DOTS_PER_LINE': 75, |
|
} |
|
|
|
PROGRESS_DOTS Example
5.13 SKED
When enabled,
SKCC
Skimmer
will read the sidebar of the SKCC Sked web page
and display members that are logged in that match your
GOALS
or
TARGETS
.
- ENABLED -
True
if you want to enable
reading the sidebar, False
otherwise.
- CHECK_SECONDS - How many seconds to wait before reading the sidebar again.
1 |
2 |
3 |
4 |
5 |
6 |
|
|
SKED = { |
|
'ENABLED': True, |
|
'CHECK_SECONDS': 60, |
|
} |
|
|
|
SKED Example
If a member that matches your goals or targets logs into the Sked page,
SKCC
Skimmer
will display a plus sign (
+
) before their call sign.
5.14 LOG_FILE
Specifies whether you want each matching spot to be written to a log file. Because
this file can accumulate over many sessions and multiple days, the date is also included
on each line.
- ENABLED -
True
to create a logfile, otherwise
False
.
- FILE_NAME - The name of the log file.
- DELETE_ON_STARTUP -
True
if you want the log file to be
created fresh for each run. Otherwise set it to False
.
1 |
2 |
3 |
4 |
5 |
6 |
7 |
|
|
LOG_FILE = { |
|
'ENABLED' : False, |
|
'FILE_NAME' : 'skcc_skimmer.log', |
|
'DELETE_ON_STARTUP' : False, |
|
} |
|
|
|
LOG_FILE Example
5.15 HIGH_WPM
This item allows you to decide whether you see spots regarding stations
that are likely not on a straight key or are otherwise sending faster than
you know you can copy.
- ACTION - What action to take when a spot has a
WPM
value above THRESHOLD
.
- suppress - Do not display the spot if it is
HIGH_WPM
.
- warn - Display a warning if the
WPM
is at or above THRESHOLD
.
- always-display - Display the spot including the
WPM
value.
- THRESHOLD - A spot is considered
HIGH_WPM
if it
has a WPM
at or above this value.
1 |
2 |
3 |
4 |
5 |
6 |
|
|
HIGH_WPM = { |
|
'ACTION': 'suppress', # Valid values: 'suppress', 'warn', 'always-display' |
|
'THRESHOLD': 20, # in WPM |
|
} |
|
|
|
HIGH_WPM Example
5.16 OFF_FREQUENCY
This indicates what to do when a member spot is not on an SKCC frequency.
- ACTION - What action to take when a spot is outside
an SKCC frequency range but is otherwise a good member spot.
- suppress - Do not display the spot if it is outside of an SKCC
frequency range.
- warn - Display a warning if the spot is off frequency.
- TOLERANCE - Specifies how many kHz above or below an SKCC frequency midpoint
is considered off frequency.
1 |
2 |
3 |
4 |
5 |
6 |
|
|
OFF_FREQUENCY = { |
|
'ACTION': 'suppress', # Valid values: 'suppress', 'warn' |
|
'TOLERANCE': 10, # +/- kHz |
|
} |
|
|
|
OFF_FREQUENCY Example
5.17 NOTIFICATION
This section controls audible notification of new spots.
- ENABLED -
True
to enable audible
notifications, False
otherwise.
- CONDITION - When to beep. Valid values:
- '
goals
' - Beep if a spot matches one or more of your goals.
- '
targets
' - Beep if a spot matches one or more of your targets.
- '
friends
' - Beep if a spot matches a friend.
These conditions can be combined, comma separated. E.g. 'goals,friends'
, which
is the default.
- RENOTIFICATION_DELAY_SECONDS - Once you are notified of a
spotted callsign, you will not be notified again - for that callsign - for
this amount of time. In other words, there is a timer per callsign.
Beeps will only occur when something new comes along,
whether it be a new person that matches your goals or targets logging into
the Sked Page, or, similarly, someone being spotted by RBN. Make sure
that your Windows "default beep" is set to something other than 'none' and
that you have your speakers unmuted and volume up. You can test your
sounds by going to the Windows 'control panel', 'sounds' tab
of the 'sound' form.
1 |
2 |
3 |
4 |
5 |
6 |
7 |
|
|
NOTIFICATION = { |
|
'ENABLED': True, |
|
'CONDITION': 'goals,friends', # Valid values: 'goals', 'targets', 'friends'. Comma separated. |
|
'RENOTIFICATION_DELAY_SECONDS': 60, |
|
} |
|
|
|
NOTIFICATION Example
5.18 VERBOSE
When VERBOSE is set to
True
,
SKCC
Skimmer
will display the raw
incoming data from the Reverse Beacon Network in addition to displaying
all the
SKCC
Skimmer
filtered spots.
When
VERBOSE
is enabled,
PROGRESS_DOTS
are automatically disabled.
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
|
|
CONNECTED to K7MJG (skimmer.k7mjg.com:60001)... |
|
DX de JA4ZRK-#: 10129.1 7L1VET/1 CW 16 dB 25 WPM CQ 0221Z |
|
DX de K2NNY-#: 14048.9 KF7WNS CW 12 dB 17 WPM CQ 0221Z |
|
0221Z KF7WNS ( 9895 Tx8 Gary OR) on 14048.9 by K2NNY(2087mi, 12dB), YOU need them for C,WAS,WAS-C,P(new +9895), THEY need you for Cx2 |
|
DX de EI6IZ-#: 7016.4 DL3DRN CW 40 dB 27 WPM CQ 0221Z |
|
DX de DF7GB-#: 14014.5 CX5UA CW 6 dB 27 WPM CQ 0221Z |
|
DX de AA4VV-#: 7042.3 KC0W CW 27 dB 31 WPM CQ 0221Z |
|
DX de AA4VV-#: 10114.4 W0GV CW 14 dB 18 WPM CQ 0221Z |
|
0221Z W0GV ( 7889 Gerry CO) on 10114.4 by AA4VV(1806mi, 14dB), YOU need them for C,WAS,P(new +7889), THEY need you for C |
|
DX de AA4VV-#: 3540.1 W8MMM CW 28 dB 23 WPM CQ 0221Z |
|
DX de DL1EMY-#: 7012.2 UA9W CW 20 dB 28 WPM CQ 0222Z |
|
DX de ZL2HAM-#: 21018.3 K9NW CW 11 dB 30 WPM CQ 0222Z |
|
DX de W4KAZ-#: 14026.6 PW2D CW 35 dB 27 WPM CQ 0222Z |
|
DX de AC0C-#: 7055.0 KT4TN CW 24 dB 11 WPM CQ 0222Z |
|
0222Z KT4TN (11943 S Randy TN) on 7055.0 by AC0C(1039mi, 24dB), YOU need them for C,WAS,WAS-C,P(new +11943), THEY need you for Cx2 |
|
DX de IK3STG-#: 14013.0 ZX150ITU CW 4 dB 37 WPM CQ 0222Z |
|
DX de IK3STG-#: 7012.2 UA9W CW 24 dB 29 WPM CQ 0222Z |
|
DX de W4KKN-#: 7004.1 PW2F CW 16 dB 27 WPM CQ 0222Z |
|
DX de AA4VV-#: 7010.7 K3IE CW 28 dB 29 WPM CQ 0223Z |
|
DX de HA1VHF-#: 7012.2 UA9W CW 24 dB 29 WPM CQ 0223Z |
|
DX de N7TR-#: 14010.1 KW9E CW 42 dB 31 WPM CQ 0223Z |
|
DX de WZ7I-#: 7012.0 PP5UP CW 16 dB 27 WPM CQ 0223Z |
|
DX de WZ7I-#: 3522.6 9A2AJ CW 21 dB 28 WPM CQ 0223Z |
|
DX de WZ7I-#: 7058.0 W4MA/4 CW 12 dB 19 WPM CQ 0223Z |
|
0223Z W4MA ( 1456 Bill GA) on 7058.0 by WZ7I(2082mi, 12dB), YOU need them for C,WAS,P(new +1456), THEY need you for C |
|
DX de WZ7I-#: 3525.3 VE3ODX CW 28 dB 14 WPM CQ 0223Z |
|
DX de WZ7I-#: 7010.6 K3IE CW 28 dB 29 WPM CQ 0223Z |
|
|
|
VERBOSE set to True
1 |
2 |
3 |
4 |
5 |
6 |
7 |
|
|
CONNECTED to K7MJG (skimmer.k7mjg.com:60001)... |
|
0221Z KF7WNS ( 9895 Tx8 Gary OR) on 14048.9 by K2NNY(2087mi, 12dB), YOU need them for C,WAS,WAS-C,P(new +9895), THEY need you for Cx2 |
|
0221Z W0GV ( 7889 Gerry CO) on 10114.4 by AA4VV(1806mi, 14dB), YOU need them for C,WAS,P(new +7889), THEY need you for C |
|
0222Z KT4TN (11943 S Randy TN) on 7055.0 by AC0C(1039mi, 24dB), YOU need them for C,WAS,WAS-C,P(new +11943), THEY need you for Cx2 |
|
0223Z W4MA ( 1456 Bill GA) on 7058.0 by WZ7I(2082mi, 12dB), YOU need them for C,WAS,P(new +1456), THEY need you for C |
|
|
|
VERBOSE set to False