Skip to content
nevermore1983Public

About

A personal wildlife sighting journal for Windows: record what you see in seconds, then explore your sightings on a calendar, a map and in statistics. Everything stays on your PC and works offline.

Topics

Resources

Code of conduct

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Thicket

A personal wildlife sighting journal for Windows: record what you see in seconds, then explore your sightings on a calendar, a map and in statistics. Everything stays on your PC and works offline.

Website: https://nevermore1983.github.io/Thicket/

Thicket was called WildLife up to version 1.1.0. Installing Thicket over WildLife upgrades it in place: your sightings, photos, settings and backups carry straight on.

Download

Download the latest Thicket installer: the file called Thicket-Setup-<version>.exe.

Run it. It installs for your Windows account only, with no administrator password, and adds Thicket to the Start menu. Running a newer installer upgrades your copy.

When Thicket first starts, choose where you record: the UK (its species list is built in) or a US state (its species pack downloads in a few seconds). You can change or add regions later in Settings › Region.

  • Windows may say "Windows protected your PC", because the installer isn't signed with a paid certificate. Click More info, then Run anyway.
  • Your data lives in %LOCALAPPDATA%\WildLife (the folder keeps the app's first name). Upgrading and uninstalling never touch it.

What changed in each version: CHANGELOG.md. How the installer works: docs/14-packaging.md.

Status

Version 1.5.1. See docs/ for the research, specification, architecture, UI design and each phase's record, and prototype/index.html for the clickable design prototype.

Developer setup

Requires uv. uv installs the right Python (3.13) automatically.

uv sync                      # create .venv and install everything
uv run wildlife              # start the app
uv run pytest                # run the tests
uv run ruff check .          # lint
uv run ruff format .         # format
uv run python scripts/make_demo_data.py --data-dir local_data/demo --sightings 20000

Building a release (needs Inno Setup 7):

uv run --with "pyinstaller==6.22.3" python scripts/build_exe.py   # app folder + smoke test
uv run python scripts/build_installer.py                        # installer + install check

Licence

Thicket is free software under the GNU General Public License v3: you may use, change and share it, and copies you share (changed or not) must come with their source under the same licence. The libraries, fonts and species data it includes keep their own licences, listed in THIRD-PARTY-NOTICES.txt in the installed program folder.

Project layout

Folder What's in it
src/wildlife/domain Plain data classes and rules (no Qt, no SQL)
src/wildlife/data Database connection, migrations and all SQL
src/wildlife/services The app's actions: save a sighting, back up, import…
src/wildlife/ui Windows, pages, components and theme
tests/ Automated tests
scripts/ Developer tools (demo data, species catalogue, benchmark, build)
packaging/ Installer script and licence texts
spikes/ Throwaway experiments that answered a risky question
docs/ Design documents
site/ The website: plain HTML and CSS, published by .github/workflows/pages.yml

About

A personal wildlife sighting journal for Windows: record what you see in seconds, then explore your sightings on a calendar, a map and in statistics. Everything stays on your PC and works offline.

Topics

Resources

Code of conduct

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages