Skip to content

Commit 299dad4

Browse files
authored
Merge pull request #3 from masenf/update-readme
Update readme
2 parents 74319ea + 7d0ae36 commit 299dad4

File tree

2 files changed

+28
-13
lines changed

2 files changed

+28
-13
lines changed

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
.pyc
2+
.tox
3+
OUTPUT

README.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# example-codeplug
22

3+
Generate DMR codeplugs from a variety of online sources using
4+
[dzcb](https://github.com/mycodeplug/dzcb).
5+
36
## Requirements
47

58
* linux or macOS (windows not yet supported)
@@ -14,23 +17,32 @@ Create / edit codeplug source files under [`/input`](/input).
1417
If multiple subdirectories exist under `/input`, then multiple
1518
codeplugs will be generated.
1619

20+
### See [dzcb README.md](https://github.com/mycodeplug/dzcb#dzcb) for
21+
more information on input files and formats.
22+
1723
## Generating
1824

1925
### Github Actions
2026

21-
If you forked this repo, first click the "Actions" tab and
22-
enable Github Actions for your fork.
23-
24-
To use Repeaterbook, go to [Settings > Secrets](../../settings/secrets/actions)
25-
and add `REPEATERBOOK_USER` and `REPEATERBOOK_PASSWD` with your
26-
repeaterbook account credentials.
27-
28-
Any changes pushed to this repository will trigger an
29-
automatic rebuild of all codeplugs in `input` that have
30-
an executable `generate.sh` file.
31-
32-
Creating a [release](../../releases) will cause Github Actions to
33-
upload a `.zip` containing all of the generated codeplugs.
27+
* Fork this repo
28+
* In the newly forked repo, click the "Actions" tab and
29+
enable Github Actions for your fork.
30+
* Rename `input/kf7hvm` to `input/your-call`
31+
* customize generate.sh and other files
32+
* `kf7hvm-md-uv380.json`: set your Radio ID and Radio Name
33+
* Copy templates from [default-tyt-md380](https://github.com/mycodeplug/dzcb/blob/main/codeplug/default-tyt-md380) for
34+
monoband variants.
35+
* `order.json`: preferred zone order, zone exclusion, preferred talkgroup order
36+
* `scanlists.json`: additional scanlists
37+
* To use Repeaterbook, go to [Settings > Secrets](../../settings/secrets/actions)
38+
and set the following variables:
39+
* REPEATERBOOK_USER
40+
* REPEATERBOOK_PASSWD
41+
* `prox.csv`: customize zones
42+
* Github [`codeplugs`](.github/workflows/codeplugs.yml) workflow
43+
will automatically build all codeplugs in the [`input`](./input) directory.
44+
* When a [Release](../../releases) is published, the generated
45+
codeplugs will be hosted publicly with a stable URL.
3446

3547
### Manual
3648

0 commit comments

Comments
 (0)