diff --git a/README.md b/README.md
index 4c6c51b..95420aa 100644
--- a/README.md
+++ b/README.md
@@ -1,183 +1,122 @@
-
-You may not use BirdNET-Pi to develop a commercial product!!!!
-
- BirdNET-Pi
-
-
-A realtime acoustic bird classification system for the Raspberry Pi 5, 4B, 400, 3B+, and 0W2
-
-
-
-
-Icon made by Freepik from www.flaticon.com
-
+# AvianVisitors
-## About this fork:
-I've been building on [mcguirepr89's](https://github.com/mcguirepr89/BirdNET-Pi) most excellent work to further update and improve BirdNET-Pi. Maybe someone will find it useful.
+*A live bird collage from your apartment window.*
-Changes include:
+A frontend overlay for [BirdNET-Pi](https://github.com/Nachtzuster/BirdNET-Pi). Listens to your balcony, identifies every passing bird with Cornell's [BirdNET](https://birdnet.cornell.edu/), and renders the detections as a tile-packed kachō-e print at `http://birdnet.local/collage/`. Full project writeup at [teddywarner.org/Projects/AvianVisitors](https://teddywarner.org/Projects/AvianVisitors/).
- - Backup & Restore
- - Web ui is much more responsive
- - Daily charts now include all species, not just top/bottom 10
- - Bump apprise version, so more notification type are possible
- - Swipe events on Daily Charts (by @croisez)
- - Support for 'Species range model V2.4 - V2'
- - Bookworm and Trixie support
- - Experimental support for writing transient files to tmpfs
- - Rework analysis to consolidate analysis/server/extraction. Should make analysis more robust and slightly more efficient, especially on installations with a large number of recordings
- - Bump tflite_runtime to 2.17.1, it is faster
- - Rework daily_plot.py (chart_viewer) to run as a daemon to avoid the very expensive startup
- - Lots of fixes & cleanups
+Out of Spaces ](https://www.lestanneries.fr/exposition/marie-lelouche-out-of-spaces/) using BirdNET-Pi in post-sculpture VR! [Press Kit](https://github.com/mcguirepr89/BirdNET-Pi-assets/blob/main/dp_out_of_spaces_marie_lelouche_digital_05_01_22.pdf)
-- [Research on noded BirdNET-Pi networks for farming](https://github.com/mcguirepr89/BirdNET-Pi-assets/blob/main/G23_Report_ModelBasedSysEngineering_FarmMarkBirdDetector_V1__Copy_.pdf)
-- [PixCams Build Guide](https://pixcams.com/building-a-birdnet-pi-real-time-acoustic-bird-id-station/)
-- [Core-Electronics](https://core-electronics.com.au/projects/bird-calls-raspberry-pi) Build Article
-- [RaspberryPi.com Blog Post](https://www.raspberrypi.com/news/classify-birds-acoustically-with-birdnet-pi/)
-- [MagPi Issue 119 Showcase Article](https://magpi.raspberrypi.com/issues/119/pdf)
-
-
-### Internationalization:
-The bird names are in English by default, but other localized versions are available thanks to the wonderful efforts of [@patlevin](https://github.com/patlevin) and Wikipedia. Use the web interface's "Tools" > "Settings" and select your "Database Language" to have the detections in your language.
-
-[Internationalization](docs/translations.md)
-
-
-## Screenshots
-
-
-
-
-## :thinking:
-Are you a lucky ducky with a spare Raspberry Pi? [Try Folding@home!](https://foldingathome.org/)
+- [Fork this repository](https://github.com/Twarner491/AvianVisitors/fork)
+- [Watch this repo](https://github.com/Twarner491/AvianVisitors/subscription)
+- [Create issue](https://github.com/Twarner491/AvianVisitors/issues/new)
diff --git a/README.upstream.md b/README.upstream.md
new file mode 100644
index 0000000..4c6c51b
--- /dev/null
+++ b/README.upstream.md
@@ -0,0 +1,183 @@
+
+You may not use BirdNET-Pi to develop a commercial product!!!!
+
+ BirdNET-Pi
+
+
+A realtime acoustic bird classification system for the Raspberry Pi 5, 4B, 400, 3B+, and 0W2
+
+
+
+
+Icon made by Freepik from www.flaticon.com
+
+
+## About this fork:
+I've been building on [mcguirepr89's](https://github.com/mcguirepr89/BirdNET-Pi) most excellent work to further update and improve BirdNET-Pi. Maybe someone will find it useful.
+
+Changes include:
+
+ - Backup & Restore
+ - Web ui is much more responsive
+ - Daily charts now include all species, not just top/bottom 10
+ - Bump apprise version, so more notification type are possible
+ - Swipe events on Daily Charts (by @croisez)
+ - Support for 'Species range model V2.4 - V2'
+ - Bookworm and Trixie support
+ - Experimental support for writing transient files to tmpfs
+ - Rework analysis to consolidate analysis/server/extraction. Should make analysis more robust and slightly more efficient, especially on installations with a large number of recordings
+ - Bump tflite_runtime to 2.17.1, it is faster
+ - Rework daily_plot.py (chart_viewer) to run as a daemon to avoid the very expensive startup
+ - Lots of fixes & cleanups
+
+!! note: see 'Migrating' on how to migrate from mcguirepr89
+
+## Introduction
+BirdNET-Pi is built on the [BirdNET framework](https://github.com/kahst/BirdNET-Analyzer) by [**@kahst**](https://github.com/kahst) Out of Spaces ](https://www.lestanneries.fr/exposition/marie-lelouche-out-of-spaces/) using BirdNET-Pi in post-sculpture VR! [Press Kit](https://github.com/mcguirepr89/BirdNET-Pi-assets/blob/main/dp_out_of_spaces_marie_lelouche_digital_05_01_22.pdf)
+- [Research on noded BirdNET-Pi networks for farming](https://github.com/mcguirepr89/BirdNET-Pi-assets/blob/main/G23_Report_ModelBasedSysEngineering_FarmMarkBirdDetector_V1__Copy_.pdf)
+- [PixCams Build Guide](https://pixcams.com/building-a-birdnet-pi-real-time-acoustic-bird-id-station/)
+- [Core-Electronics](https://core-electronics.com.au/projects/bird-calls-raspberry-pi) Build Article
+- [RaspberryPi.com Blog Post](https://www.raspberrypi.com/news/classify-birds-acoustically-with-birdnet-pi/)
+- [MagPi Issue 119 Showcase Article](https://magpi.raspberrypi.com/issues/119/pdf)
+
+
+### Internationalization:
+The bird names are in English by default, but other localized versions are available thanks to the wonderful efforts of [@patlevin](https://github.com/patlevin) and Wikipedia. Use the web interface's "Tools" > "Settings" and select your "Database Language" to have the detections in your language.
+
+[Internationalization](docs/translations.md)
+
+
+## Screenshots
+
+
+
+
+## :thinking:
+Are you a lucky ducky with a spare Raspberry Pi? [Try Folding@home!](https://foldingathome.org/)
diff --git a/avian/api/birdnet-api.php b/avian/api/birdnet-api.php
new file mode 100644
index 0000000..8dcc80a
--- /dev/null
+++ b/avian/api/birdnet-api.php
@@ -0,0 +1,183 @@
+: detail page for one species
+
+declare(strict_types=1);
+header('Content-Type: application/json; charset=utf-8');
+header('Cache-Control: public, max-age=30');
+
+$DB_PATH = '/home/monalisa/BirdNET-Pi/scripts/birds.db';
+
+if (!file_exists($DB_PATH)) {
+ http_response_code(503);
+ echo json_encode(['error' => 'birds.db not found']);
+ exit;
+}
+
+try {
+ $db = new SQLite3($DB_PATH, SQLITE3_OPEN_READONLY);
+ $db->busyTimeout(2000);
+} catch (Throwable $e) {
+ http_response_code(500);
+ echo json_encode(['error' => 'db open failed']);
+ exit;
+}
+
+function rows(SQLite3 $db, string $sql, array $bind = []): array {
+ $stmt = $db->prepare($sql);
+ foreach ($bind as $k => $v) $stmt->bindValue($k, $v);
+ $res = $stmt->execute();
+ $out = [];
+ while ($r = $res->fetchArray(SQLITE3_ASSOC)) $out[] = $r;
+ return $out;
+}
+function one(SQLite3 $db, string $sql, array $bind = []) {
+ $r = rows($db, $sql, $bind);
+ return $r[0] ?? null;
+}
+
+$action = $_GET['action'] ?? 'stats';
+
+switch ($action) {
+
+ case 'stats': {
+ $total = (int)(one($db, 'SELECT COUNT(*) AS n FROM detections')['n'] ?? 0);
+ $species = (int)(one($db, 'SELECT COUNT(DISTINCT Sci_Name) AS n FROM detections')['n'] ?? 0);
+ $today = (int)(one($db, "SELECT COUNT(*) AS n FROM detections WHERE Date = DATE('now','localtime')")['n'] ?? 0);
+ $todaySpec = (int)(one($db, "SELECT COUNT(DISTINCT Sci_Name) AS n FROM detections WHERE Date = DATE('now','localtime')")['n'] ?? 0);
+ $lastHour = (int)(one($db, "SELECT COUNT(*) AS n FROM detections WHERE Date = DATE('now','localtime') AND Time >= TIME('now','localtime','-1 hour')")['n'] ?? 0);
+ $week = (int)(one($db, "SELECT COUNT(*) AS n FROM detections WHERE Date >= DATE('now','localtime','-7 day')")['n'] ?? 0);
+ $weekSpec = (int)(one($db, "SELECT COUNT(DISTINCT Sci_Name) AS n FROM detections WHERE Date >= DATE('now','localtime','-7 day')")['n'] ?? 0);
+ $first = one($db, 'SELECT MIN(Date) AS d FROM detections');
+ echo json_encode([
+ 'totals' => ['detections' => $total, 'species' => $species],
+ 'today' => ['detections' => $today, 'species' => $todaySpec],
+ 'last_hour' => ['detections' => $lastHour],
+ 'week' => ['detections' => $week, 'species' => $weekSpec],
+ 'started' => $first['d'] ?? null,
+ 'as_of' => date('c'),
+ ]);
+ break;
+ }
+
+ case 'lifelist': {
+ $rs = rows($db,
+ "SELECT Sci_Name AS sci, Com_Name AS com, MIN(Date||' '||Time) AS first_seen, "
+ . " MAX(Date||' '||Time) AS last_seen, COUNT(*) AS total, MAX(Confidence) AS best_conf "
+ . "FROM detections GROUP BY Sci_Name ORDER BY first_seen ASC"
+ );
+ echo json_encode(['species' => $rs, 'as_of' => date('c')]);
+ break;
+ }
+
+ case 'recent': {
+ // Cap raised to 1,000,000 hours (~114 years) so the frontend's
+ // "ALL" button can effectively turn off the time filter without
+ // needing a separate code path.
+ $hours = max(1, min(1000000, (int)($_GET['hours'] ?? 24)));
+ // species-collapsed view: one row per species seen in the window,
+ // with the file of its highest-confidence detection inside the window.
+ $rs = rows($db,
+ "SELECT Sci_Name AS sci, Com_Name AS com, COUNT(*) AS n, MAX(Confidence) AS best_conf, "
+ . " MAX(Date||' '||Time) AS last_seen "
+ . "FROM detections "
+ . "WHERE (julianday('now','localtime') - julianday(Date||' '||Time)) * 24 <= :hrs "
+ . "GROUP BY Sci_Name ORDER BY last_seen DESC",
+ [':hrs' => $hours]
+ );
+ // for each row, attach the file of the top-confidence detection in the window
+ foreach ($rs as &$r) {
+ $best = one($db,
+ "SELECT File_Name AS file, Date AS d, Time AS t, Confidence AS conf "
+ . "FROM detections "
+ . "WHERE Sci_Name = :sn "
+ . "AND (julianday('now','localtime') - julianday(Date||' '||Time)) * 24 <= :hrs "
+ . "ORDER BY Confidence DESC LIMIT 1",
+ [':sn' => $r['sci'], ':hrs' => $hours]
+ );
+ $r['top_file'] = $best['file'] ?? null;
+ $r['top_at'] = isset($best['d']) ? ($best['d'].' '.$best['t']) : null;
+ }
+ echo json_encode(['hours' => $hours, 'species' => $rs, 'as_of' => date('c')]);
+ break;
+ }
+
+ case 'species': {
+ $sci = $_GET['sci'] ?? '';
+ if ($sci === '') { http_response_code(400); echo json_encode(['error' => 'sci= required']); break; }
+ $detections = rows($db,
+ "SELECT Date AS d, Time AS t, File_Name AS file, Confidence AS conf "
+ . "FROM detections WHERE Sci_Name = :sn ORDER BY Date DESC, Time DESC LIMIT 500",
+ [':sn' => $sci]
+ );
+ $summary = one($db,
+ "SELECT Com_Name AS com, COUNT(*) AS total, MIN(Date||' '||Time) AS first_seen, "
+ . " MAX(Date||' '||Time) AS last_seen, MAX(Confidence) AS best_conf "
+ . "FROM detections WHERE Sci_Name = :sn",
+ [':sn' => $sci]
+ );
+ echo json_encode(['sci' => $sci, 'summary' => $summary, 'detections' => $detections]);
+ break;
+ }
+
+ case 'timeseries': {
+ // Aggregated time-bucketed counts for the stats charts.
+ // daily — last $days days, detections + unique species per day
+ // by_hour — detections grouped by hour of day, last 30 days
+ // The frontend backfills missing dates with zero — sparse data days
+ // are otherwise dropped by the GROUP BY.
+ $days = max(1, min(90, (int)($_GET['days'] ?? 30)));
+ $daily = rows($db,
+ "SELECT Date AS date, COUNT(*) AS detections, COUNT(DISTINCT Sci_Name) AS species "
+ . "FROM detections "
+ . "WHERE Date >= DATE('now','localtime','-".($days - 1)." day') "
+ . "GROUP BY Date ORDER BY Date"
+ );
+ $by_hour = rows($db,
+ "SELECT CAST(strftime('%H', Time) AS INT) AS hour, COUNT(*) AS detections "
+ . "FROM detections "
+ . "WHERE Date >= DATE('now','localtime','-30 day') "
+ . "GROUP BY hour ORDER BY hour"
+ );
+ echo json_encode([
+ 'days' => $days,
+ 'daily' => $daily,
+ 'by_hour' => $by_hour,
+ 'as_of' => date('c'),
+ ]);
+ break;
+ }
+
+ case 'firstseen': {
+ // Most recent additions to the life list — first detection per
+ // species, sorted by first_seen DESC. Powers the "First Detections"
+ // section on the stats view.
+ $limit = max(1, min(50, (int)($_GET['limit'] ?? 10)));
+ $rs = rows($db,
+ "SELECT Sci_Name AS sci, Com_Name AS com, MIN(Date||' '||Time) AS first_seen, "
+ . " COUNT(*) AS total "
+ . "FROM detections GROUP BY Sci_Name ORDER BY first_seen DESC LIMIT :lim",
+ [':lim' => $limit]
+ );
+ echo json_encode(['species' => $rs, 'as_of' => date('c')]);
+ break;
+ }
+
+ default:
+ http_response_code(404);
+ echo json_encode(['error' => 'unknown action']);
+}
diff --git a/avian/api/cutout.php b/avian/api/cutout.php
new file mode 100644
index 0000000..6dbd6fe
--- /dev/null
+++ b/avian/api/cutout.php
@@ -0,0 +1,134 @@
+).
+//
+// Lives in the Caddy file-server root so the BirdNET-Pi auto-update doesn't
+// touch it. Each new species hits this once: download Wikipedia/Macaulay
+// image → rembg via /usr/local/bin/rembg-cli → cache transparent PNG to
+// disk under cutouts/. Subsequent requests are instant readfile() from cache.
+//
+// Auth: the Caddy site block 403s anything missing X-BirdNET-Proxy-Token at
+// the top, so this script inherits the Worker-only access guarantee.
+//
+// Pre-reqs (run once via /install/rembg-setup.sh):
+// - /home/monalisa/rembg-env/bin/rembg (Python venv)
+// - /usr/local/bin/rembg-cli (wrapper)
+// - /home/monalisa/BirdSongs/Extracted/cutouts/ (cache dir, monalisa-owned)
+
+declare(strict_types=1);
+
+$sci = trim((string)($_GET['sci'] ?? ''));
+if ($sci === '') {
+ http_response_code(400);
+ echo 'sci required';
+ exit;
+}
+
+// Slugify scientific name for the cache filename.
+$slug = preg_replace('/[^a-z0-9]+/', '-', strtolower($sci));
+$slug = trim((string)$slug, '-');
+$cacheDir = '/home/monalisa/BirdSongs/Extracted/cutouts';
+$cachePath = "$cacheDir/$slug.png";
+
+function serve_png(string $path): void {
+ header('Content-Type: image/png');
+ header('Cache-Control: public, max-age=2592000');
+ header('Content-Length: ' . filesize($path));
+ readfile($path);
+ exit;
+}
+
+// Cache hit — short-circuit.
+if (is_file($cachePath) && filesize($cachePath) > 1024) {
+ serve_png($cachePath);
+}
+
+// Make sure the cache dir exists (first run).
+if (!is_dir($cacheDir)) @mkdir($cacheDir, 0755, true);
+
+// Resolve a source image URL. Wikipedia summary first (free, fast,
+// no auth, has a clean originalimage for most birds).
+$ctx = stream_context_create([
+ 'http' => [
+ 'header' => "User-Agent: apartment-birds/1.0 (twarner491@gmail.com)\r\n",
+ 'timeout' => 12,
+ ],
+]);
+$wpUrl = 'https://en.wikipedia.org/api/rest_v1/page/summary/' . rawurlencode($sci);
+$wpJson = @file_get_contents($wpUrl, false, $ctx);
+$srcUrl = null;
+if ($wpJson !== false) {
+ $j = json_decode($wpJson, true);
+ $srcUrl = $j['originalimage']['source'] ?? $j['thumbnail']['source'] ?? null;
+}
+if (!$srcUrl) {
+ http_response_code(404);
+ echo 'no upstream image for ' . htmlspecialchars($sci);
+ exit;
+}
+
+// Download the source image.
+$imgBytes = @file_get_contents($srcUrl, false, $ctx);
+if (!$imgBytes || strlen($imgBytes) < 1024) {
+ http_response_code(503);
+ echo 'failed to fetch source image';
+ exit;
+}
+
+// Run rembg via the wrapper. We use temp files because rembg's CLI prefers
+// real paths. u2netp is the lightweight model (~50MB peak RAM) — important
+// on the Pi 3B+ (1GB total RAM). Call with --post-process-mask to clean
+// up edges.
+$tmpIn = tempnam('/tmp', 'rembg-in-') . '.jpg';
+$tmpOut = tempnam('/tmp', 'rembg-out-') . '.png';
+file_put_contents($tmpIn, $imgBytes);
+
+$cmd = sprintf(
+ '/usr/local/bin/rembg-cli i -m u2netp -ppm %s %s 2>&1',
+ escapeshellarg($tmpIn),
+ escapeshellarg($tmpOut)
+);
+$out = shell_exec($cmd);
+@unlink($tmpIn);
+
+if (!is_file($tmpOut) || filesize($tmpOut) < 1024) {
+ @unlink($tmpOut);
+ http_response_code(500);
+ header('Content-Type: text/plain');
+ echo "rembg failed:\n" . ($out ?? '(no output)');
+ exit;
+}
+
+// 1. Alpha-crop to bounding box so each PNG == the bird's actual shape
+// (no transparent padding around it). Lets the layout pack tiles tight.
+// 2. Resize down to a max edge of 800px so the cache stays small.
+$im = @imagecreatefrompng($tmpOut);
+if ($im !== false) {
+ $cropped = @imagecropauto($im, IMG_CROP_TRANSPARENT);
+ if ($cropped !== false) {
+ imagedestroy($im);
+ $im = $cropped;
+ }
+ $w = imagesx($im); $h = imagesy($im);
+ $max = 800;
+ if ($w > $max || $h > $max) {
+ $scale = $max / max($w, $h);
+ $nw = (int)($w * $scale); $nh = (int)($h * $scale);
+ $resized = imagecreatetruecolor($nw, $nh);
+ imagealphablending($resized, false);
+ imagesavealpha($resized, true);
+ imagecopyresampled($resized, $im, 0, 0, 0, 0, $nw, $nh, $w, $h);
+ imagedestroy($im);
+ $im = $resized;
+ }
+ imagealphablending($im, false);
+ imagesavealpha($im, true);
+ imagepng($im, $tmpOut, 6);
+ imagedestroy($im);
+}
+
+// Cache + serve.
+copy($tmpOut, $cachePath);
+@unlink($tmpOut);
+serve_png($cachePath);
diff --git a/avian/api/recording.php b/avian/api/recording.php
new file mode 100644
index 0000000..1f69969
--- /dev/null
+++ b/avian/api/recording.php
@@ -0,0 +1,176 @@
+.
+//
+// BirdNET-Pi writes audio + spectrograms to
+// ~/BirdSongs/Extracted/By_Date/YYYY-MM-DD//---birdnet-.mp3
+// We pull the date out of the filename to locate the species
+// directory under By_Date/. Whitelisted character set keeps this
+// safe against path-traversal payloads.
+if ($file !== '') {
+ if (!preg_match('/^[A-Za-z0-9_.:-]+\.mp3$/', $file)) {
+ http_response_code(400);
+ echo 'invalid file name';
+ exit;
+ }
+ // Extract the YYYY-MM-DD from the filename if present.
+ $date = null;
+ if (preg_match('/(\d{4}-\d{2}-\d{2})/', $file, $m)) $date = $m[1];
+ // The species directory is the prefix before the first dash-digit.
+ // Try a couple of strategies: explicit species_dir param, dir from file
+ // prefix, then a broader recursive search as fallback.
+ $candidates = [];
+ if ($date) {
+ // Look in that specific date dir across every species subdir.
+ $dayDir = "$BY_DATE/$date";
+ if (is_dir($dayDir)) {
+ foreach (scandir($dayDir) as $sub) {
+ if ($sub[0] === '.') continue;
+ $p = "$dayDir/$sub/$file";
+ if (is_file($p)) { $candidates[] = $p; break; }
+ }
+ }
+ }
+ if (!$candidates) {
+ // Fall back to scanning every date dir (slower).
+ if (is_dir($BY_DATE)) {
+ foreach (scandir($BY_DATE) as $d) {
+ if ($d[0] === '.') continue;
+ $dayDir = "$BY_DATE/$d";
+ if (!is_dir($dayDir)) continue;
+ foreach (scandir($dayDir) as $sub) {
+ if ($sub[0] === '.') continue;
+ $p = "$dayDir/$sub/$file";
+ if (is_file($p)) { $candidates[] = $p; break 2; }
+ }
+ }
+ }
+ }
+ if (!$candidates || filesize($candidates[0]) < 64) {
+ http_response_code(404);
+ echo 'recording not found';
+ exit;
+ }
+ $path = $candidates[0];
+ header('Content-Type: audio/mpeg');
+ header('Content-Length: ' . filesize($path));
+ header('Cache-Control: public, max-age=86400');
+ header('Accept-Ranges: bytes');
+ readfile($path);
+ exit;
+}
+$BIRDS_JSON_CANDIDATES = [
+ '/home/monalisa/BirdNET-Pi/scripts/birds.json',
+ '/home/monalisa/BirdNET-Pi/model/labels.txt',
+];
+
+// ---- Resolve scientific name → common name (with underscores) ----
+function resolve_common(string $sci): ?string {
+ // Try birds.json first (preferred — has clean sci/com pairs).
+ foreach (['/home/monalisa/BirdNET-Pi/scripts/birds.json'] as $f) {
+ if (is_readable($f)) {
+ $list = json_decode((string)file_get_contents($f), true);
+ if (is_array($list)) {
+ foreach ($list as $row) {
+ if (!is_array($row)) continue;
+ $rowSci = $row['sci'] ?? $row['scientific'] ?? $row['scientificName'] ?? '';
+ $rowCom = $row['com'] ?? $row['common'] ?? $row['commonName'] ?? '';
+ if (strcasecmp(trim((string)$rowSci), $sci) === 0 && $rowCom) {
+ return str_replace(' ', '_', (string)$rowCom);
+ }
+ }
+ }
+ }
+ }
+ // Fallback: labels.txt has "_" or ", " per line.
+ $labels = '/home/monalisa/BirdNET-Pi/model/labels.txt';
+ if (is_readable($labels)) {
+ foreach (file($labels, FILE_IGNORE_NEW_LINES) as $line) {
+ if (strpos($line, '_') !== false) {
+ [$s, $c] = explode('_', $line, 2);
+ if (strcasecmp(trim($s), $sci) === 0) {
+ return str_replace(' ', '_', trim($c));
+ }
+ }
+ }
+ }
+ return null;
+}
+
+$common = resolve_common($sci);
+if ($common === null) {
+ // Last-ditch: try the scientific name itself, with spaces → underscores.
+ // (Some BirdNET dirs are keyed by sci name.)
+ $common = str_replace(' ', '_', $sci);
+}
+
+// ---- Find newest matching file ----
+// Walk By_Date/* newest-first; inside each date dir, look for a
+// subdirectory named exactly $common, return the newest .mp3 inside.
+function newest_recording(string $rootDir, string $common): ?string {
+ if (!is_dir($rootDir)) return null;
+ $dates = scandir($rootDir, SCANDIR_SORT_DESCENDING);
+ if (!$dates) return null;
+ foreach ($dates as $date) {
+ if ($date[0] === '.') continue;
+ $speciesDir = "$rootDir/$date/$common";
+ if (!is_dir($speciesDir)) continue;
+ $files = scandir($speciesDir, SCANDIR_SORT_DESCENDING);
+ if (!$files) continue;
+ foreach ($files as $f) {
+ if (substr($f, -4) === '.mp3') {
+ return "$speciesDir/$f";
+ }
+ }
+ }
+ return null;
+}
+
+$path = newest_recording($BY_DATE, $common);
+if ($path === null || !is_file($path) || filesize($path) < 64) {
+ http_response_code(404);
+ echo 'no recording for ' . htmlspecialchars($sci);
+ exit;
+}
+
+// ---- Serve ----
+header('Content-Type: audio/mpeg');
+header('Content-Length: ' . filesize($path));
+header('Cache-Control: public, max-age=60');
+header('Accept-Ranges: bytes');
+readfile($path);
diff --git a/avian/api/spectrogram.php b/avian/api/spectrogram.php
new file mode 100644
index 0000000..d5f8669
--- /dev/null
+++ b/avian/api/spectrogram.php
@@ -0,0 +1,155 @@
+//) — just .png instead of .mp3.
+//
+// Endpoints:
+// ?sci= → newest spectrogram for that species
+// ?file=.mp3 → spectrogram next to that specific
+// recording (atlas modal uses this so the
+// strip below each play button is the
+// spectrogram for that recording, not
+// "the most recent" — they can differ).
+
+declare(strict_types=1);
+
+$sci = trim((string)($_GET['sci'] ?? ''));
+$file = trim((string)($_GET['file'] ?? ''));
+
+if ($sci === '' && $file === '') {
+ http_response_code(400);
+ echo 'sci or file required';
+ exit;
+}
+
+// Reject any sci-name that isn't a clean Genus species[ subspecies[ tri]]
+// pattern. Same defence-in-depth check as recording.php.
+if ($sci !== '' && !preg_match('/^[A-Za-z]{2,40}(?:[ ][a-z]{2,40}){1,3}$/', $sci)) {
+ http_response_code(400);
+ echo 'invalid sci';
+ exit;
+}
+
+$BY_DATE = '/home/monalisa/BirdSongs/Extracted/By_Date';
+
+// ---- Direct-by-file lookup ----
+// BirdNET-Pi writes //. So we accept the mp3 filename, swap
+// the extension, and search the same way recording.php does.
+if ($file !== '') {
+ if (!preg_match('/^[A-Za-z0-9_.:-]+\.(mp3|png)$/', $file)) {
+ http_response_code(400);
+ echo 'invalid file name';
+ exit;
+ }
+ // BirdNET-Pi names the spectrogram as the FULL mp3 filename plus
+ // ".png" — e.g. "American_Crow-82-…-20:25:29.mp3" pairs with
+ // "American_Crow-82-…-20:25:29.mp3.png" (not "…-20:25:29.png").
+ // Accept either form gracefully.
+ if (substr($file, -4) === '.png') {
+ $png = $file;
+ } else {
+ $png = $file . '.png';
+ }
+ $date = null;
+ if (preg_match('/(\d{4}-\d{2}-\d{2})/', $png, $m)) $date = $m[1];
+ $candidates = [];
+ if ($date) {
+ $dayDir = "$BY_DATE/$date";
+ if (is_dir($dayDir)) {
+ foreach (scandir($dayDir) as $sub) {
+ if ($sub[0] === '.') continue;
+ $p = "$dayDir/$sub/$png";
+ if (is_file($p)) { $candidates[] = $p; break; }
+ }
+ }
+ }
+ if (!$candidates) {
+ if (is_dir($BY_DATE)) {
+ foreach (scandir($BY_DATE) as $d) {
+ if ($d[0] === '.') continue;
+ $dayDir = "$BY_DATE/$d";
+ if (!is_dir($dayDir)) continue;
+ foreach (scandir($dayDir) as $sub) {
+ if ($sub[0] === '.') continue;
+ $p = "$dayDir/$sub/$png";
+ if (is_file($p)) { $candidates[] = $p; break 2; }
+ }
+ }
+ }
+ }
+ if (!$candidates || filesize($candidates[0]) < 64) {
+ http_response_code(404);
+ echo 'spectrogram not found';
+ exit;
+ }
+ $path = $candidates[0];
+ header('Content-Type: image/png');
+ header('Content-Length: ' . filesize($path));
+ header('Cache-Control: public, max-age=86400');
+ readfile($path);
+ exit;
+}
+
+function resolve_common(string $sci): ?string {
+ $f = '/home/monalisa/BirdNET-Pi/scripts/birds.json';
+ if (is_readable($f)) {
+ $list = json_decode((string)file_get_contents($f), true);
+ if (is_array($list)) {
+ foreach ($list as $row) {
+ if (!is_array($row)) continue;
+ $rowSci = $row['sci'] ?? $row['scientific'] ?? $row['scientificName'] ?? '';
+ $rowCom = $row['com'] ?? $row['common'] ?? $row['commonName'] ?? '';
+ if (strcasecmp(trim((string)$rowSci), $sci) === 0 && $rowCom) {
+ return str_replace(' ', '_', (string)$rowCom);
+ }
+ }
+ }
+ }
+ $labels = '/home/monalisa/BirdNET-Pi/model/labels.txt';
+ if (is_readable($labels)) {
+ foreach (file($labels, FILE_IGNORE_NEW_LINES) as $line) {
+ if (strpos($line, '_') !== false) {
+ [$s, $c] = explode('_', $line, 2);
+ if (strcasecmp(trim($s), $sci) === 0) {
+ return str_replace(' ', '_', trim($c));
+ }
+ }
+ }
+ }
+ return null;
+}
+
+$common = resolve_common($sci) ?? str_replace(' ', '_', $sci);
+
+function newest_spectrogram(string $rootDir, string $common): ?string {
+ if (!is_dir($rootDir)) return null;
+ $dates = scandir($rootDir, SCANDIR_SORT_DESCENDING);
+ if (!$dates) return null;
+ foreach ($dates as $date) {
+ if ($date[0] === '.') continue;
+ $speciesDir = "$rootDir/$date/$common";
+ if (!is_dir($speciesDir)) continue;
+ $files = scandir($speciesDir, SCANDIR_SORT_DESCENDING);
+ if (!$files) continue;
+ foreach ($files as $f) {
+ if (substr($f, -4) === '.png') {
+ return "$speciesDir/$f";
+ }
+ }
+ }
+ return null;
+}
+
+$path = newest_spectrogram($BY_DATE, $common);
+if ($path === null || !is_file($path) || filesize($path) < 64) {
+ http_response_code(404);
+ echo 'no spectrogram for ' . htmlspecialchars($sci);
+ exit;
+}
+
+header('Content-Type: image/png');
+header('Content-Length: ' . filesize($path));
+header('Cache-Control: public, max-age=60');
+readfile($path);
diff --git a/avian/assets/cutouts/aechmophorus-occidentalis.png b/avian/assets/cutouts/aechmophorus-occidentalis.png
new file mode 100644
index 0000000..b85daba
Binary files /dev/null and b/avian/assets/cutouts/aechmophorus-occidentalis.png differ
diff --git a/avian/assets/cutouts/agelaius-phoeniceus.png b/avian/assets/cutouts/agelaius-phoeniceus.png
new file mode 100644
index 0000000..9ce9564
Binary files /dev/null and b/avian/assets/cutouts/agelaius-phoeniceus.png differ
diff --git a/avian/assets/cutouts/ammodramus-savannarum.png b/avian/assets/cutouts/ammodramus-savannarum.png
new file mode 100644
index 0000000..17d27a2
Binary files /dev/null and b/avian/assets/cutouts/ammodramus-savannarum.png differ
diff --git a/avian/assets/cutouts/amphispiza-bilineata.png b/avian/assets/cutouts/amphispiza-bilineata.png
new file mode 100644
index 0000000..e74bebd
Binary files /dev/null and b/avian/assets/cutouts/amphispiza-bilineata.png differ
diff --git a/avian/assets/cutouts/anas-crecca.png b/avian/assets/cutouts/anas-crecca.png
new file mode 100644
index 0000000..1733c4e
Binary files /dev/null and b/avian/assets/cutouts/anas-crecca.png differ
diff --git a/avian/assets/cutouts/anthus-rubescens.png b/avian/assets/cutouts/anthus-rubescens.png
new file mode 100644
index 0000000..db48910
Binary files /dev/null and b/avian/assets/cutouts/anthus-rubescens.png differ
diff --git a/avian/assets/cutouts/aphelocoma-californica.png b/avian/assets/cutouts/aphelocoma-californica.png
new file mode 100644
index 0000000..fa79a3b
Binary files /dev/null and b/avian/assets/cutouts/aphelocoma-californica.png differ
diff --git a/avian/assets/cutouts/aphelocoma-woodhouseii.png b/avian/assets/cutouts/aphelocoma-woodhouseii.png
new file mode 100644
index 0000000..77e1234
Binary files /dev/null and b/avian/assets/cutouts/aphelocoma-woodhouseii.png differ
diff --git a/avian/assets/cutouts/archilochus-alexandri.png b/avian/assets/cutouts/archilochus-alexandri.png
new file mode 100644
index 0000000..b289e0f
Binary files /dev/null and b/avian/assets/cutouts/archilochus-alexandri.png differ
diff --git a/avian/assets/cutouts/artemisiospiza-belli.png b/avian/assets/cutouts/artemisiospiza-belli.png
new file mode 100644
index 0000000..4ff8d75
Binary files /dev/null and b/avian/assets/cutouts/artemisiospiza-belli.png differ
diff --git a/avian/assets/cutouts/asio-otus.png b/avian/assets/cutouts/asio-otus.png
new file mode 100644
index 0000000..40765ef
Binary files /dev/null and b/avian/assets/cutouts/asio-otus.png differ
diff --git a/avian/assets/cutouts/aythya-americana.png b/avian/assets/cutouts/aythya-americana.png
new file mode 100644
index 0000000..d8a384c
Binary files /dev/null and b/avian/assets/cutouts/aythya-americana.png differ
diff --git a/avian/assets/cutouts/baeolophus-inornatus.png b/avian/assets/cutouts/baeolophus-inornatus.png
new file mode 100644
index 0000000..355e21a
Binary files /dev/null and b/avian/assets/cutouts/baeolophus-inornatus.png differ
diff --git a/avian/assets/cutouts/bombycilla-cedrorum.png b/avian/assets/cutouts/bombycilla-cedrorum.png
new file mode 100644
index 0000000..67d93ff
Binary files /dev/null and b/avian/assets/cutouts/bombycilla-cedrorum.png differ
diff --git a/avian/assets/cutouts/bombycilla-garrulus.png b/avian/assets/cutouts/bombycilla-garrulus.png
new file mode 100644
index 0000000..2a7221e
Binary files /dev/null and b/avian/assets/cutouts/bombycilla-garrulus.png differ
diff --git a/avian/assets/cutouts/branta-canadensis.png b/avian/assets/cutouts/branta-canadensis.png
new file mode 100644
index 0000000..a5539e0
Binary files /dev/null and b/avian/assets/cutouts/branta-canadensis.png differ
diff --git a/avian/assets/cutouts/bubo-virginianus.png b/avian/assets/cutouts/bubo-virginianus.png
new file mode 100644
index 0000000..2cf2d61
Binary files /dev/null and b/avian/assets/cutouts/bubo-virginianus.png differ
diff --git a/avian/assets/cutouts/bubulcus-ibis.png b/avian/assets/cutouts/bubulcus-ibis.png
new file mode 100644
index 0000000..a3316bb
Binary files /dev/null and b/avian/assets/cutouts/bubulcus-ibis.png differ
diff --git a/avian/assets/cutouts/bucephala-clangula.png b/avian/assets/cutouts/bucephala-clangula.png
new file mode 100644
index 0000000..7f5099e
Binary files /dev/null and b/avian/assets/cutouts/bucephala-clangula.png differ
diff --git a/avian/assets/cutouts/buteo-lagopus.png b/avian/assets/cutouts/buteo-lagopus.png
new file mode 100644
index 0000000..be89cae
Binary files /dev/null and b/avian/assets/cutouts/buteo-lagopus.png differ
diff --git a/avian/assets/cutouts/calamospiza-melanocorys.png b/avian/assets/cutouts/calamospiza-melanocorys.png
new file mode 100644
index 0000000..664f627
Binary files /dev/null and b/avian/assets/cutouts/calamospiza-melanocorys.png differ
diff --git a/avian/assets/cutouts/calothorax-lucifer.png b/avian/assets/cutouts/calothorax-lucifer.png
new file mode 100644
index 0000000..ecf248d
Binary files /dev/null and b/avian/assets/cutouts/calothorax-lucifer.png differ
diff --git a/avian/assets/cutouts/calypte-anna.png b/avian/assets/cutouts/calypte-anna.png
new file mode 100644
index 0000000..6e54586
Binary files /dev/null and b/avian/assets/cutouts/calypte-anna.png differ
diff --git a/avian/assets/cutouts/cardellina-pusilla.png b/avian/assets/cutouts/cardellina-pusilla.png
new file mode 100644
index 0000000..0b31ee1
Binary files /dev/null and b/avian/assets/cutouts/cardellina-pusilla.png differ
diff --git a/avian/assets/cutouts/cardellina-rubrifrons.png b/avian/assets/cutouts/cardellina-rubrifrons.png
new file mode 100644
index 0000000..8f4d8c3
Binary files /dev/null and b/avian/assets/cutouts/cardellina-rubrifrons.png differ
diff --git a/avian/assets/cutouts/catharus-guttatus.png b/avian/assets/cutouts/catharus-guttatus.png
new file mode 100644
index 0000000..63ef6de
Binary files /dev/null and b/avian/assets/cutouts/catharus-guttatus.png differ
diff --git a/avian/assets/cutouts/catharus-ustulatus.png b/avian/assets/cutouts/catharus-ustulatus.png
new file mode 100644
index 0000000..c3942dd
Binary files /dev/null and b/avian/assets/cutouts/catharus-ustulatus.png differ
diff --git a/avian/assets/cutouts/catherpes-mexicanus.png b/avian/assets/cutouts/catherpes-mexicanus.png
new file mode 100644
index 0000000..06bd3a5
Binary files /dev/null and b/avian/assets/cutouts/catherpes-mexicanus.png differ
diff --git a/avian/assets/cutouts/certhia-americana.png b/avian/assets/cutouts/certhia-americana.png
new file mode 100644
index 0000000..63a6866
Binary files /dev/null and b/avian/assets/cutouts/certhia-americana.png differ
diff --git a/avian/assets/cutouts/chondestes-grammacus.png b/avian/assets/cutouts/chondestes-grammacus.png
new file mode 100644
index 0000000..469e304
Binary files /dev/null and b/avian/assets/cutouts/chondestes-grammacus.png differ
diff --git a/avian/assets/cutouts/cinclus-mexicanus.png b/avian/assets/cutouts/cinclus-mexicanus.png
new file mode 100644
index 0000000..fc36276
Binary files /dev/null and b/avian/assets/cutouts/cinclus-mexicanus.png differ
diff --git a/avian/assets/cutouts/cistothorus-palustris.png b/avian/assets/cutouts/cistothorus-palustris.png
new file mode 100644
index 0000000..0d9bb4a
Binary files /dev/null and b/avian/assets/cutouts/cistothorus-palustris.png differ
diff --git a/avian/assets/cutouts/coccothraustes-vespertinus.png b/avian/assets/cutouts/coccothraustes-vespertinus.png
new file mode 100644
index 0000000..b4f6cd4
Binary files /dev/null and b/avian/assets/cutouts/coccothraustes-vespertinus.png differ
diff --git a/avian/assets/cutouts/columba-livia.png b/avian/assets/cutouts/columba-livia.png
new file mode 100644
index 0000000..d17bf45
Binary files /dev/null and b/avian/assets/cutouts/columba-livia.png differ
diff --git a/avian/assets/cutouts/contopus-sordidulus.png b/avian/assets/cutouts/contopus-sordidulus.png
new file mode 100644
index 0000000..d06b5d1
Binary files /dev/null and b/avian/assets/cutouts/contopus-sordidulus.png differ
diff --git a/avian/assets/cutouts/corvus-brachyrhynchos.png b/avian/assets/cutouts/corvus-brachyrhynchos.png
new file mode 100644
index 0000000..5effae4
Binary files /dev/null and b/avian/assets/cutouts/corvus-brachyrhynchos.png differ
diff --git a/avian/assets/cutouts/corvus-corax.png b/avian/assets/cutouts/corvus-corax.png
new file mode 100644
index 0000000..1e40d61
Binary files /dev/null and b/avian/assets/cutouts/corvus-corax.png differ
diff --git a/avian/assets/cutouts/cyanocitta-stelleri.png b/avian/assets/cutouts/cyanocitta-stelleri.png
new file mode 100644
index 0000000..d5e6c57
Binary files /dev/null and b/avian/assets/cutouts/cyanocitta-stelleri.png differ
diff --git a/avian/assets/cutouts/dryobates-villosus.png b/avian/assets/cutouts/dryobates-villosus.png
new file mode 100644
index 0000000..b87e225
Binary files /dev/null and b/avian/assets/cutouts/dryobates-villosus.png differ
diff --git a/avian/assets/cutouts/empidonax-difficilis.png b/avian/assets/cutouts/empidonax-difficilis.png
new file mode 100644
index 0000000..dcd0deb
Binary files /dev/null and b/avian/assets/cutouts/empidonax-difficilis.png differ
diff --git a/avian/assets/cutouts/empidonax-hammondii.png b/avian/assets/cutouts/empidonax-hammondii.png
new file mode 100644
index 0000000..b8ae12b
Binary files /dev/null and b/avian/assets/cutouts/empidonax-hammondii.png differ
diff --git a/avian/assets/cutouts/empidonax-oberholseri.png b/avian/assets/cutouts/empidonax-oberholseri.png
new file mode 100644
index 0000000..88a9180
Binary files /dev/null and b/avian/assets/cutouts/empidonax-oberholseri.png differ
diff --git a/avian/assets/cutouts/empidonax-traillii.png b/avian/assets/cutouts/empidonax-traillii.png
new file mode 100644
index 0000000..72a898a
Binary files /dev/null and b/avian/assets/cutouts/empidonax-traillii.png differ
diff --git a/avian/assets/cutouts/empidonax-wrightii.png b/avian/assets/cutouts/empidonax-wrightii.png
new file mode 100644
index 0000000..d2602d0
Binary files /dev/null and b/avian/assets/cutouts/empidonax-wrightii.png differ
diff --git a/avian/assets/cutouts/eremophila-alpestris.png b/avian/assets/cutouts/eremophila-alpestris.png
new file mode 100644
index 0000000..e477cfc
Binary files /dev/null and b/avian/assets/cutouts/eremophila-alpestris.png differ
diff --git a/avian/assets/cutouts/euphagus-cyanocephalus.png b/avian/assets/cutouts/euphagus-cyanocephalus.png
new file mode 100644
index 0000000..1493347
Binary files /dev/null and b/avian/assets/cutouts/euphagus-cyanocephalus.png differ
diff --git a/avian/assets/cutouts/falco-mexicanus.png b/avian/assets/cutouts/falco-mexicanus.png
new file mode 100644
index 0000000..0b8aaff
Binary files /dev/null and b/avian/assets/cutouts/falco-mexicanus.png differ
diff --git a/avian/assets/cutouts/geothlypis-tolmiei.png b/avian/assets/cutouts/geothlypis-tolmiei.png
new file mode 100644
index 0000000..62e44cf
Binary files /dev/null and b/avian/assets/cutouts/geothlypis-tolmiei.png differ
diff --git a/avian/assets/cutouts/geothlypis-trichas.png b/avian/assets/cutouts/geothlypis-trichas.png
new file mode 100644
index 0000000..69917ae
Binary files /dev/null and b/avian/assets/cutouts/geothlypis-trichas.png differ
diff --git a/avian/assets/cutouts/gymnogyps-californianus.png b/avian/assets/cutouts/gymnogyps-californianus.png
new file mode 100644
index 0000000..b848ff5
Binary files /dev/null and b/avian/assets/cutouts/gymnogyps-californianus.png differ
diff --git a/avian/assets/cutouts/haemorhous-mexicanus.png b/avian/assets/cutouts/haemorhous-mexicanus.png
new file mode 100644
index 0000000..c69d565
Binary files /dev/null and b/avian/assets/cutouts/haemorhous-mexicanus.png differ
diff --git a/avian/assets/cutouts/haemorhous-purpureus.png b/avian/assets/cutouts/haemorhous-purpureus.png
new file mode 100644
index 0000000..0d581a8
Binary files /dev/null and b/avian/assets/cutouts/haemorhous-purpureus.png differ
diff --git a/avian/assets/cutouts/hirundo-rustica.png b/avian/assets/cutouts/hirundo-rustica.png
new file mode 100644
index 0000000..921a6b9
Binary files /dev/null and b/avian/assets/cutouts/hirundo-rustica.png differ
diff --git a/avian/assets/cutouts/icteria-virens.png b/avian/assets/cutouts/icteria-virens.png
new file mode 100644
index 0000000..d8f7c15
Binary files /dev/null and b/avian/assets/cutouts/icteria-virens.png differ
diff --git a/avian/assets/cutouts/icterus-bullockii.png b/avian/assets/cutouts/icterus-bullockii.png
new file mode 100644
index 0000000..270eb88
Binary files /dev/null and b/avian/assets/cutouts/icterus-bullockii.png differ
diff --git a/avian/assets/cutouts/icterus-cucullatus.png b/avian/assets/cutouts/icterus-cucullatus.png
new file mode 100644
index 0000000..1b737f7
Binary files /dev/null and b/avian/assets/cutouts/icterus-cucullatus.png differ
diff --git a/avian/assets/cutouts/icterus-galbula.png b/avian/assets/cutouts/icterus-galbula.png
new file mode 100644
index 0000000..626c630
Binary files /dev/null and b/avian/assets/cutouts/icterus-galbula.png differ
diff --git a/avian/assets/cutouts/icterus-parisorum.png b/avian/assets/cutouts/icterus-parisorum.png
new file mode 100644
index 0000000..09026b5
Binary files /dev/null and b/avian/assets/cutouts/icterus-parisorum.png differ
diff --git a/avian/assets/cutouts/ixoreus-naevius.png b/avian/assets/cutouts/ixoreus-naevius.png
new file mode 100644
index 0000000..53b14f1
Binary files /dev/null and b/avian/assets/cutouts/ixoreus-naevius.png differ
diff --git a/avian/assets/cutouts/junco-hyemalis.png b/avian/assets/cutouts/junco-hyemalis.png
new file mode 100644
index 0000000..8739f4c
Binary files /dev/null and b/avian/assets/cutouts/junco-hyemalis.png differ
diff --git a/avian/assets/cutouts/lanius-ludovicianus.png b/avian/assets/cutouts/lanius-ludovicianus.png
new file mode 100644
index 0000000..0ecb379
Binary files /dev/null and b/avian/assets/cutouts/lanius-ludovicianus.png differ
diff --git a/avian/assets/cutouts/larus-occidentalis.png b/avian/assets/cutouts/larus-occidentalis.png
new file mode 100644
index 0000000..7c3102f
Binary files /dev/null and b/avian/assets/cutouts/larus-occidentalis.png differ
diff --git a/avian/assets/cutouts/leiothlypis-celata.png b/avian/assets/cutouts/leiothlypis-celata.png
new file mode 100644
index 0000000..9be0305
Binary files /dev/null and b/avian/assets/cutouts/leiothlypis-celata.png differ
diff --git a/avian/assets/cutouts/leiothlypis-lucidae.png b/avian/assets/cutouts/leiothlypis-lucidae.png
new file mode 100644
index 0000000..3785d23
Binary files /dev/null and b/avian/assets/cutouts/leiothlypis-lucidae.png differ
diff --git a/avian/assets/cutouts/leucophaeus-pipixcan.png b/avian/assets/cutouts/leucophaeus-pipixcan.png
new file mode 100644
index 0000000..5722fe3
Binary files /dev/null and b/avian/assets/cutouts/leucophaeus-pipixcan.png differ
diff --git a/avian/assets/cutouts/loxia-curvirostra.png b/avian/assets/cutouts/loxia-curvirostra.png
new file mode 100644
index 0000000..cbf3e82
Binary files /dev/null and b/avian/assets/cutouts/loxia-curvirostra.png differ
diff --git a/avian/assets/cutouts/melanerpes-formicivorus.png b/avian/assets/cutouts/melanerpes-formicivorus.png
new file mode 100644
index 0000000..f84a822
Binary files /dev/null and b/avian/assets/cutouts/melanerpes-formicivorus.png differ
diff --git a/avian/assets/cutouts/melospiza-georgiana.png b/avian/assets/cutouts/melospiza-georgiana.png
new file mode 100644
index 0000000..0bffcad
Binary files /dev/null and b/avian/assets/cutouts/melospiza-georgiana.png differ
diff --git a/avian/assets/cutouts/melospiza-lincolnii.png b/avian/assets/cutouts/melospiza-lincolnii.png
new file mode 100644
index 0000000..0e598c5
Binary files /dev/null and b/avian/assets/cutouts/melospiza-lincolnii.png differ
diff --git a/avian/assets/cutouts/melospiza-melodia.png b/avian/assets/cutouts/melospiza-melodia.png
new file mode 100644
index 0000000..8fab8b6
Binary files /dev/null and b/avian/assets/cutouts/melospiza-melodia.png differ
diff --git a/avian/assets/cutouts/melozone-aberti.png b/avian/assets/cutouts/melozone-aberti.png
new file mode 100644
index 0000000..a00c133
Binary files /dev/null and b/avian/assets/cutouts/melozone-aberti.png differ
diff --git a/avian/assets/cutouts/melozone-crissalis.png b/avian/assets/cutouts/melozone-crissalis.png
new file mode 100644
index 0000000..f082f63
Binary files /dev/null and b/avian/assets/cutouts/melozone-crissalis.png differ
diff --git a/avian/assets/cutouts/melozone-fusca.png b/avian/assets/cutouts/melozone-fusca.png
new file mode 100644
index 0000000..7db426d
Binary files /dev/null and b/avian/assets/cutouts/melozone-fusca.png differ
diff --git a/avian/assets/cutouts/mimus-polyglottos.png b/avian/assets/cutouts/mimus-polyglottos.png
new file mode 100644
index 0000000..5e30f06
Binary files /dev/null and b/avian/assets/cutouts/mimus-polyglottos.png differ
diff --git a/avian/assets/cutouts/mniotilta-varia.png b/avian/assets/cutouts/mniotilta-varia.png
new file mode 100644
index 0000000..db9a5b9
Binary files /dev/null and b/avian/assets/cutouts/mniotilta-varia.png differ
diff --git a/avian/assets/cutouts/molothrus-ater.png b/avian/assets/cutouts/molothrus-ater.png
new file mode 100644
index 0000000..e288292
Binary files /dev/null and b/avian/assets/cutouts/molothrus-ater.png differ
diff --git a/avian/assets/cutouts/myadestes-townsendi.png b/avian/assets/cutouts/myadestes-townsendi.png
new file mode 100644
index 0000000..cb49506
Binary files /dev/null and b/avian/assets/cutouts/myadestes-townsendi.png differ
diff --git a/avian/assets/cutouts/myiarchus-cinerascens.png b/avian/assets/cutouts/myiarchus-cinerascens.png
new file mode 100644
index 0000000..6c0db77
Binary files /dev/null and b/avian/assets/cutouts/myiarchus-cinerascens.png differ
diff --git a/avian/assets/cutouts/nucifraga-columbiana.png b/avian/assets/cutouts/nucifraga-columbiana.png
new file mode 100644
index 0000000..d1b7b15
Binary files /dev/null and b/avian/assets/cutouts/nucifraga-columbiana.png differ
diff --git a/avian/assets/cutouts/oreothlypis-ruficapilla.png b/avian/assets/cutouts/oreothlypis-ruficapilla.png
new file mode 100644
index 0000000..2f297b9
Binary files /dev/null and b/avian/assets/cutouts/oreothlypis-ruficapilla.png differ
diff --git a/avian/assets/cutouts/passer-domesticus.png b/avian/assets/cutouts/passer-domesticus.png
new file mode 100644
index 0000000..9b25de3
Binary files /dev/null and b/avian/assets/cutouts/passer-domesticus.png differ
diff --git a/avian/assets/cutouts/passerculus-sandwichensis.png b/avian/assets/cutouts/passerculus-sandwichensis.png
new file mode 100644
index 0000000..690d51b
Binary files /dev/null and b/avian/assets/cutouts/passerculus-sandwichensis.png differ
diff --git a/avian/assets/cutouts/passerella-iliaca.png b/avian/assets/cutouts/passerella-iliaca.png
new file mode 100644
index 0000000..ba93058
Binary files /dev/null and b/avian/assets/cutouts/passerella-iliaca.png differ
diff --git a/avian/assets/cutouts/passerina-amoena.png b/avian/assets/cutouts/passerina-amoena.png
new file mode 100644
index 0000000..5b74290
Binary files /dev/null and b/avian/assets/cutouts/passerina-amoena.png differ
diff --git a/avian/assets/cutouts/passerina-cyanea.png b/avian/assets/cutouts/passerina-cyanea.png
new file mode 100644
index 0000000..6d17302
Binary files /dev/null and b/avian/assets/cutouts/passerina-cyanea.png differ
diff --git a/avian/assets/cutouts/pelecanus-erythrorhynchos.png b/avian/assets/cutouts/pelecanus-erythrorhynchos.png
new file mode 100644
index 0000000..7cc8e7e
Binary files /dev/null and b/avian/assets/cutouts/pelecanus-erythrorhynchos.png differ
diff --git a/avian/assets/cutouts/perisoreus-canadensis.png b/avian/assets/cutouts/perisoreus-canadensis.png
new file mode 100644
index 0000000..7e45150
Binary files /dev/null and b/avian/assets/cutouts/perisoreus-canadensis.png differ
diff --git a/avian/assets/cutouts/petrochelidon-pyrrhonota.png b/avian/assets/cutouts/petrochelidon-pyrrhonota.png
new file mode 100644
index 0000000..837a1c1
Binary files /dev/null and b/avian/assets/cutouts/petrochelidon-pyrrhonota.png differ
diff --git a/avian/assets/cutouts/phainopepla-nitens.png b/avian/assets/cutouts/phainopepla-nitens.png
new file mode 100644
index 0000000..18b0802
Binary files /dev/null and b/avian/assets/cutouts/phainopepla-nitens.png differ
diff --git a/avian/assets/cutouts/phalacrocorax-auritus.png b/avian/assets/cutouts/phalacrocorax-auritus.png
new file mode 100644
index 0000000..c8c3dcb
Binary files /dev/null and b/avian/assets/cutouts/phalacrocorax-auritus.png differ
diff --git a/avian/assets/cutouts/pheucticus-melanocephalus.png b/avian/assets/cutouts/pheucticus-melanocephalus.png
new file mode 100644
index 0000000..8097512
Binary files /dev/null and b/avian/assets/cutouts/pheucticus-melanocephalus.png differ
diff --git a/avian/assets/cutouts/pica-nuttalli.png b/avian/assets/cutouts/pica-nuttalli.png
new file mode 100644
index 0000000..9ae31c8
Binary files /dev/null and b/avian/assets/cutouts/pica-nuttalli.png differ
diff --git a/avian/assets/cutouts/pipilo-chlorurus.png b/avian/assets/cutouts/pipilo-chlorurus.png
new file mode 100644
index 0000000..a83a07e
Binary files /dev/null and b/avian/assets/cutouts/pipilo-chlorurus.png differ
diff --git a/avian/assets/cutouts/pipilo-erythrophthalmus.png b/avian/assets/cutouts/pipilo-erythrophthalmus.png
new file mode 100644
index 0000000..872cfdb
Binary files /dev/null and b/avian/assets/cutouts/pipilo-erythrophthalmus.png differ
diff --git a/avian/assets/cutouts/pipilo-maculatus.png b/avian/assets/cutouts/pipilo-maculatus.png
new file mode 100644
index 0000000..341cd86
Binary files /dev/null and b/avian/assets/cutouts/pipilo-maculatus.png differ
diff --git a/avian/assets/cutouts/piranga-ludoviciana.png b/avian/assets/cutouts/piranga-ludoviciana.png
new file mode 100644
index 0000000..1575bbf
Binary files /dev/null and b/avian/assets/cutouts/piranga-ludoviciana.png differ
diff --git a/avian/assets/cutouts/piranga-rubra.png b/avian/assets/cutouts/piranga-rubra.png
new file mode 100644
index 0000000..6128114
Binary files /dev/null and b/avian/assets/cutouts/piranga-rubra.png differ
diff --git a/avian/assets/cutouts/poecile-gambeli.png b/avian/assets/cutouts/poecile-gambeli.png
new file mode 100644
index 0000000..2785cca
Binary files /dev/null and b/avian/assets/cutouts/poecile-gambeli.png differ
diff --git a/avian/assets/cutouts/poecile-rufescens.png b/avian/assets/cutouts/poecile-rufescens.png
new file mode 100644
index 0000000..d3d750e
Binary files /dev/null and b/avian/assets/cutouts/poecile-rufescens.png differ
diff --git a/avian/assets/cutouts/polioptila-caerulea.png b/avian/assets/cutouts/polioptila-caerulea.png
new file mode 100644
index 0000000..88857ff
Binary files /dev/null and b/avian/assets/cutouts/polioptila-caerulea.png differ
diff --git a/avian/assets/cutouts/pooecetes-gramineus.png b/avian/assets/cutouts/pooecetes-gramineus.png
new file mode 100644
index 0000000..3f56f80
Binary files /dev/null and b/avian/assets/cutouts/pooecetes-gramineus.png differ
diff --git a/avian/assets/cutouts/progne-subis.png b/avian/assets/cutouts/progne-subis.png
new file mode 100644
index 0000000..74ca3b3
Binary files /dev/null and b/avian/assets/cutouts/progne-subis.png differ
diff --git a/avian/assets/cutouts/psaltriparus-minimus.png b/avian/assets/cutouts/psaltriparus-minimus.png
new file mode 100644
index 0000000..51c7c70
Binary files /dev/null and b/avian/assets/cutouts/psaltriparus-minimus.png differ
diff --git a/avian/assets/cutouts/quiscalus-mexicanus.png b/avian/assets/cutouts/quiscalus-mexicanus.png
new file mode 100644
index 0000000..47c07ab
Binary files /dev/null and b/avian/assets/cutouts/quiscalus-mexicanus.png differ
diff --git a/avian/assets/cutouts/recurvirostra-americana.png b/avian/assets/cutouts/recurvirostra-americana.png
new file mode 100644
index 0000000..f394f4c
Binary files /dev/null and b/avian/assets/cutouts/recurvirostra-americana.png differ
diff --git a/avian/assets/cutouts/regulus-calendula.png b/avian/assets/cutouts/regulus-calendula.png
new file mode 100644
index 0000000..307ae1b
Binary files /dev/null and b/avian/assets/cutouts/regulus-calendula.png differ
diff --git a/avian/assets/cutouts/regulus-satrapa.png b/avian/assets/cutouts/regulus-satrapa.png
new file mode 100644
index 0000000..7030c65
Binary files /dev/null and b/avian/assets/cutouts/regulus-satrapa.png differ
diff --git a/avian/assets/cutouts/riparia-riparia.png b/avian/assets/cutouts/riparia-riparia.png
new file mode 100644
index 0000000..b43a682
Binary files /dev/null and b/avian/assets/cutouts/riparia-riparia.png differ
diff --git a/avian/assets/cutouts/salpinctes-obsoletus.png b/avian/assets/cutouts/salpinctes-obsoletus.png
new file mode 100644
index 0000000..5ccf3d5
Binary files /dev/null and b/avian/assets/cutouts/salpinctes-obsoletus.png differ
diff --git a/avian/assets/cutouts/sayornis-nigricans.png b/avian/assets/cutouts/sayornis-nigricans.png
new file mode 100644
index 0000000..5b50e94
Binary files /dev/null and b/avian/assets/cutouts/sayornis-nigricans.png differ
diff --git a/avian/assets/cutouts/sayornis-saya.png b/avian/assets/cutouts/sayornis-saya.png
new file mode 100644
index 0000000..b67b77d
Binary files /dev/null and b/avian/assets/cutouts/sayornis-saya.png differ
diff --git a/avian/assets/cutouts/selasphorus-sasin.png b/avian/assets/cutouts/selasphorus-sasin.png
new file mode 100644
index 0000000..c8d7962
Binary files /dev/null and b/avian/assets/cutouts/selasphorus-sasin.png differ
diff --git a/avian/assets/cutouts/setophaga-coronata.png b/avian/assets/cutouts/setophaga-coronata.png
new file mode 100644
index 0000000..f4f0216
Binary files /dev/null and b/avian/assets/cutouts/setophaga-coronata.png differ
diff --git a/avian/assets/cutouts/setophaga-magnolia.png b/avian/assets/cutouts/setophaga-magnolia.png
new file mode 100644
index 0000000..f319e3c
Binary files /dev/null and b/avian/assets/cutouts/setophaga-magnolia.png differ
diff --git a/avian/assets/cutouts/setophaga-nigrescens.png b/avian/assets/cutouts/setophaga-nigrescens.png
new file mode 100644
index 0000000..ddde7d0
Binary files /dev/null and b/avian/assets/cutouts/setophaga-nigrescens.png differ
diff --git a/avian/assets/cutouts/setophaga-occidentalis.png b/avian/assets/cutouts/setophaga-occidentalis.png
new file mode 100644
index 0000000..cef1fe8
Binary files /dev/null and b/avian/assets/cutouts/setophaga-occidentalis.png differ
diff --git a/avian/assets/cutouts/setophaga-palmarum.png b/avian/assets/cutouts/setophaga-palmarum.png
new file mode 100644
index 0000000..5747bd0
Binary files /dev/null and b/avian/assets/cutouts/setophaga-palmarum.png differ
diff --git a/avian/assets/cutouts/setophaga-petechia.png b/avian/assets/cutouts/setophaga-petechia.png
new file mode 100644
index 0000000..b7954e2
Binary files /dev/null and b/avian/assets/cutouts/setophaga-petechia.png differ
diff --git a/avian/assets/cutouts/setophaga-ruticilla.png b/avian/assets/cutouts/setophaga-ruticilla.png
new file mode 100644
index 0000000..6a96255
Binary files /dev/null and b/avian/assets/cutouts/setophaga-ruticilla.png differ
diff --git a/avian/assets/cutouts/setophaga-townsendi.png b/avian/assets/cutouts/setophaga-townsendi.png
new file mode 100644
index 0000000..dc9f5d7
Binary files /dev/null and b/avian/assets/cutouts/setophaga-townsendi.png differ
diff --git a/avian/assets/cutouts/sialia-currucoides.png b/avian/assets/cutouts/sialia-currucoides.png
new file mode 100644
index 0000000..431f8c8
Binary files /dev/null and b/avian/assets/cutouts/sialia-currucoides.png differ
diff --git a/avian/assets/cutouts/sialia-mexicana.png b/avian/assets/cutouts/sialia-mexicana.png
new file mode 100644
index 0000000..20c4231
Binary files /dev/null and b/avian/assets/cutouts/sialia-mexicana.png differ
diff --git a/avian/assets/cutouts/sitta-canadensis.png b/avian/assets/cutouts/sitta-canadensis.png
new file mode 100644
index 0000000..f6da2a0
Binary files /dev/null and b/avian/assets/cutouts/sitta-canadensis.png differ
diff --git a/avian/assets/cutouts/sitta-carolinensis.png b/avian/assets/cutouts/sitta-carolinensis.png
new file mode 100644
index 0000000..e90171a
Binary files /dev/null and b/avian/assets/cutouts/sitta-carolinensis.png differ
diff --git a/avian/assets/cutouts/sitta-pygmaea.png b/avian/assets/cutouts/sitta-pygmaea.png
new file mode 100644
index 0000000..d432727
Binary files /dev/null and b/avian/assets/cutouts/sitta-pygmaea.png differ
diff --git a/avian/assets/cutouts/spatula-discors.png b/avian/assets/cutouts/spatula-discors.png
new file mode 100644
index 0000000..27eb4e8
Binary files /dev/null and b/avian/assets/cutouts/spatula-discors.png differ
diff --git a/avian/assets/cutouts/spinus-pinus.png b/avian/assets/cutouts/spinus-pinus.png
new file mode 100644
index 0000000..28e189d
Binary files /dev/null and b/avian/assets/cutouts/spinus-pinus.png differ
diff --git a/avian/assets/cutouts/spinus-psaltria.png b/avian/assets/cutouts/spinus-psaltria.png
new file mode 100644
index 0000000..b0549af
Binary files /dev/null and b/avian/assets/cutouts/spinus-psaltria.png differ
diff --git a/avian/assets/cutouts/spinus-tristis.png b/avian/assets/cutouts/spinus-tristis.png
new file mode 100644
index 0000000..2ad56f6
Binary files /dev/null and b/avian/assets/cutouts/spinus-tristis.png differ
diff --git a/avian/assets/cutouts/spizella-atrogularis.png b/avian/assets/cutouts/spizella-atrogularis.png
new file mode 100644
index 0000000..652a7a4
Binary files /dev/null and b/avian/assets/cutouts/spizella-atrogularis.png differ
diff --git a/avian/assets/cutouts/spizella-breweri.png b/avian/assets/cutouts/spizella-breweri.png
new file mode 100644
index 0000000..22a175b
Binary files /dev/null and b/avian/assets/cutouts/spizella-breweri.png differ
diff --git a/avian/assets/cutouts/spizella-passerina.png b/avian/assets/cutouts/spizella-passerina.png
new file mode 100644
index 0000000..1909b59
Binary files /dev/null and b/avian/assets/cutouts/spizella-passerina.png differ
diff --git a/avian/assets/cutouts/spizelloides-arborea.png b/avian/assets/cutouts/spizelloides-arborea.png
new file mode 100644
index 0000000..40c89a1
Binary files /dev/null and b/avian/assets/cutouts/spizelloides-arborea.png differ
diff --git a/avian/assets/cutouts/stelgidopteryx-serripennis.png b/avian/assets/cutouts/stelgidopteryx-serripennis.png
new file mode 100644
index 0000000..24374cd
Binary files /dev/null and b/avian/assets/cutouts/stelgidopteryx-serripennis.png differ
diff --git a/avian/assets/cutouts/streptopelia-decaocto.png b/avian/assets/cutouts/streptopelia-decaocto.png
new file mode 100644
index 0000000..3481091
Binary files /dev/null and b/avian/assets/cutouts/streptopelia-decaocto.png differ
diff --git a/avian/assets/cutouts/sturnella-neglecta.png b/avian/assets/cutouts/sturnella-neglecta.png
new file mode 100644
index 0000000..52a1ae3
Binary files /dev/null and b/avian/assets/cutouts/sturnella-neglecta.png differ
diff --git a/avian/assets/cutouts/sturnus-vulgaris.png b/avian/assets/cutouts/sturnus-vulgaris.png
new file mode 100644
index 0000000..8f02929
Binary files /dev/null and b/avian/assets/cutouts/sturnus-vulgaris.png differ
diff --git a/avian/assets/cutouts/tachycineta-bicolor.png b/avian/assets/cutouts/tachycineta-bicolor.png
new file mode 100644
index 0000000..3c7a6f8
Binary files /dev/null and b/avian/assets/cutouts/tachycineta-bicolor.png differ
diff --git a/avian/assets/cutouts/tachycineta-thalassina.png b/avian/assets/cutouts/tachycineta-thalassina.png
new file mode 100644
index 0000000..016c060
Binary files /dev/null and b/avian/assets/cutouts/tachycineta-thalassina.png differ
diff --git a/avian/assets/cutouts/thryomanes-bewickii.png b/avian/assets/cutouts/thryomanes-bewickii.png
new file mode 100644
index 0000000..40745a7
Binary files /dev/null and b/avian/assets/cutouts/thryomanes-bewickii.png differ
diff --git a/avian/assets/cutouts/toxostoma-redivivum.png b/avian/assets/cutouts/toxostoma-redivivum.png
new file mode 100644
index 0000000..934fadb
Binary files /dev/null and b/avian/assets/cutouts/toxostoma-redivivum.png differ
diff --git a/avian/assets/cutouts/troglodytes-aedon.png b/avian/assets/cutouts/troglodytes-aedon.png
new file mode 100644
index 0000000..115ba2d
Binary files /dev/null and b/avian/assets/cutouts/troglodytes-aedon.png differ
diff --git a/avian/assets/cutouts/troglodytes-pacificus.png b/avian/assets/cutouts/troglodytes-pacificus.png
new file mode 100644
index 0000000..05db6b9
Binary files /dev/null and b/avian/assets/cutouts/troglodytes-pacificus.png differ
diff --git a/avian/assets/cutouts/turdus-migratorius.png b/avian/assets/cutouts/turdus-migratorius.png
new file mode 100644
index 0000000..165a683
Binary files /dev/null and b/avian/assets/cutouts/turdus-migratorius.png differ
diff --git a/avian/assets/cutouts/tyrannus-verticalis.png b/avian/assets/cutouts/tyrannus-verticalis.png
new file mode 100644
index 0000000..257652e
Binary files /dev/null and b/avian/assets/cutouts/tyrannus-verticalis.png differ
diff --git a/avian/assets/cutouts/tyrannus-vociferans.png b/avian/assets/cutouts/tyrannus-vociferans.png
new file mode 100644
index 0000000..cb896ac
Binary files /dev/null and b/avian/assets/cutouts/tyrannus-vociferans.png differ
diff --git a/avian/assets/cutouts/tyto-alba.png b/avian/assets/cutouts/tyto-alba.png
new file mode 100644
index 0000000..ec6aaa2
Binary files /dev/null and b/avian/assets/cutouts/tyto-alba.png differ
diff --git a/avian/assets/cutouts/urile-penicillatus.png b/avian/assets/cutouts/urile-penicillatus.png
new file mode 100644
index 0000000..f25a33e
Binary files /dev/null and b/avian/assets/cutouts/urile-penicillatus.png differ
diff --git a/avian/assets/cutouts/vireo-bellii.png b/avian/assets/cutouts/vireo-bellii.png
new file mode 100644
index 0000000..ebfcf4a
Binary files /dev/null and b/avian/assets/cutouts/vireo-bellii.png differ
diff --git a/avian/assets/cutouts/vireo-cassinii.png b/avian/assets/cutouts/vireo-cassinii.png
new file mode 100644
index 0000000..052cc58
Binary files /dev/null and b/avian/assets/cutouts/vireo-cassinii.png differ
diff --git a/avian/assets/cutouts/vireo-gilvus.png b/avian/assets/cutouts/vireo-gilvus.png
new file mode 100644
index 0000000..6237b83
Binary files /dev/null and b/avian/assets/cutouts/vireo-gilvus.png differ
diff --git a/avian/assets/cutouts/vireo-huttoni.png b/avian/assets/cutouts/vireo-huttoni.png
new file mode 100644
index 0000000..204c3b4
Binary files /dev/null and b/avian/assets/cutouts/vireo-huttoni.png differ
diff --git a/avian/assets/cutouts/xanthocephalus-xanthocephalus.png b/avian/assets/cutouts/xanthocephalus-xanthocephalus.png
new file mode 100644
index 0000000..83f8843
Binary files /dev/null and b/avian/assets/cutouts/xanthocephalus-xanthocephalus.png differ
diff --git a/avian/assets/cutouts/zenaida-asiatica.png b/avian/assets/cutouts/zenaida-asiatica.png
new file mode 100644
index 0000000..4092be2
Binary files /dev/null and b/avian/assets/cutouts/zenaida-asiatica.png differ
diff --git a/avian/assets/cutouts/zenaida-macroura.png b/avian/assets/cutouts/zenaida-macroura.png
new file mode 100644
index 0000000..8e0a71f
Binary files /dev/null and b/avian/assets/cutouts/zenaida-macroura.png differ
diff --git a/avian/assets/cutouts/zonotrichia-atricapilla.png b/avian/assets/cutouts/zonotrichia-atricapilla.png
new file mode 100644
index 0000000..b456e8a
Binary files /dev/null and b/avian/assets/cutouts/zonotrichia-atricapilla.png differ
diff --git a/avian/assets/cutouts/zonotrichia-leucophrys.png b/avian/assets/cutouts/zonotrichia-leucophrys.png
new file mode 100644
index 0000000..439ba8a
Binary files /dev/null and b/avian/assets/cutouts/zonotrichia-leucophrys.png differ
diff --git a/avian/assets/cutouts/zonotrichia-querula.png b/avian/assets/cutouts/zonotrichia-querula.png
new file mode 100644
index 0000000..6c11143
Binary files /dev/null and b/avian/assets/cutouts/zonotrichia-querula.png differ
diff --git a/avian/assets/illustrations/acanthis-flammea-2.png b/avian/assets/illustrations/acanthis-flammea-2.png
new file mode 100644
index 0000000..c9a803b
Binary files /dev/null and b/avian/assets/illustrations/acanthis-flammea-2.png differ
diff --git a/avian/assets/illustrations/acanthis-flammea.png b/avian/assets/illustrations/acanthis-flammea.png
new file mode 100644
index 0000000..c62ad99
Binary files /dev/null and b/avian/assets/illustrations/acanthis-flammea.png differ
diff --git a/avian/assets/illustrations/accipiter-cooperii-2.png b/avian/assets/illustrations/accipiter-cooperii-2.png
new file mode 100644
index 0000000..6d685ac
Binary files /dev/null and b/avian/assets/illustrations/accipiter-cooperii-2.png differ
diff --git a/avian/assets/illustrations/accipiter-cooperii.png b/avian/assets/illustrations/accipiter-cooperii.png
new file mode 100644
index 0000000..8931d7d
Binary files /dev/null and b/avian/assets/illustrations/accipiter-cooperii.png differ
diff --git a/avian/assets/illustrations/accipiter-gentilis-2.png b/avian/assets/illustrations/accipiter-gentilis-2.png
new file mode 100644
index 0000000..c9691a3
Binary files /dev/null and b/avian/assets/illustrations/accipiter-gentilis-2.png differ
diff --git a/avian/assets/illustrations/accipiter-gentilis.png b/avian/assets/illustrations/accipiter-gentilis.png
new file mode 100644
index 0000000..8b4bf33
Binary files /dev/null and b/avian/assets/illustrations/accipiter-gentilis.png differ
diff --git a/avian/assets/illustrations/accipiter-striatus-2.png b/avian/assets/illustrations/accipiter-striatus-2.png
new file mode 100644
index 0000000..9348817
Binary files /dev/null and b/avian/assets/illustrations/accipiter-striatus-2.png differ
diff --git a/avian/assets/illustrations/accipiter-striatus.png b/avian/assets/illustrations/accipiter-striatus.png
new file mode 100644
index 0000000..8a22557
Binary files /dev/null and b/avian/assets/illustrations/accipiter-striatus.png differ
diff --git a/avian/assets/illustrations/actitis-macularius-2.png b/avian/assets/illustrations/actitis-macularius-2.png
new file mode 100644
index 0000000..cc6ce3c
Binary files /dev/null and b/avian/assets/illustrations/actitis-macularius-2.png differ
diff --git a/avian/assets/illustrations/actitis-macularius.png b/avian/assets/illustrations/actitis-macularius.png
new file mode 100644
index 0000000..5e99ec8
Binary files /dev/null and b/avian/assets/illustrations/actitis-macularius.png differ
diff --git a/avian/assets/illustrations/aechmophorus-occidentalis-2.png b/avian/assets/illustrations/aechmophorus-occidentalis-2.png
new file mode 100644
index 0000000..258fba3
Binary files /dev/null and b/avian/assets/illustrations/aechmophorus-occidentalis-2.png differ
diff --git a/avian/assets/illustrations/aechmophorus-occidentalis.png b/avian/assets/illustrations/aechmophorus-occidentalis.png
new file mode 100644
index 0000000..7ce5af3
Binary files /dev/null and b/avian/assets/illustrations/aechmophorus-occidentalis.png differ
diff --git a/avian/assets/illustrations/aegolius-acadicus-2.png b/avian/assets/illustrations/aegolius-acadicus-2.png
new file mode 100644
index 0000000..a85a784
Binary files /dev/null and b/avian/assets/illustrations/aegolius-acadicus-2.png differ
diff --git a/avian/assets/illustrations/aegolius-acadicus.png b/avian/assets/illustrations/aegolius-acadicus.png
new file mode 100644
index 0000000..bb2db33
Binary files /dev/null and b/avian/assets/illustrations/aegolius-acadicus.png differ
diff --git a/avian/assets/illustrations/aeronautes-saxatalis-2.png b/avian/assets/illustrations/aeronautes-saxatalis-2.png
new file mode 100644
index 0000000..f64d994
Binary files /dev/null and b/avian/assets/illustrations/aeronautes-saxatalis-2.png differ
diff --git a/avian/assets/illustrations/aeronautes-saxatalis.png b/avian/assets/illustrations/aeronautes-saxatalis.png
new file mode 100644
index 0000000..e0e0e19
Binary files /dev/null and b/avian/assets/illustrations/aeronautes-saxatalis.png differ
diff --git a/avian/assets/illustrations/agelaius-phoeniceus-2.png b/avian/assets/illustrations/agelaius-phoeniceus-2.png
new file mode 100644
index 0000000..e09f809
Binary files /dev/null and b/avian/assets/illustrations/agelaius-phoeniceus-2.png differ
diff --git a/avian/assets/illustrations/agelaius-phoeniceus.png b/avian/assets/illustrations/agelaius-phoeniceus.png
new file mode 100644
index 0000000..08fc564
Binary files /dev/null and b/avian/assets/illustrations/agelaius-phoeniceus.png differ
diff --git a/avian/assets/illustrations/aix-sponsa-2.png b/avian/assets/illustrations/aix-sponsa-2.png
new file mode 100644
index 0000000..048b686
Binary files /dev/null and b/avian/assets/illustrations/aix-sponsa-2.png differ
diff --git a/avian/assets/illustrations/aix-sponsa.png b/avian/assets/illustrations/aix-sponsa.png
new file mode 100644
index 0000000..fdb131f
Binary files /dev/null and b/avian/assets/illustrations/aix-sponsa.png differ
diff --git a/avian/assets/illustrations/ammodramus-savannarum-2.png b/avian/assets/illustrations/ammodramus-savannarum-2.png
new file mode 100644
index 0000000..1b515c5
Binary files /dev/null and b/avian/assets/illustrations/ammodramus-savannarum-2.png differ
diff --git a/avian/assets/illustrations/ammodramus-savannarum.png b/avian/assets/illustrations/ammodramus-savannarum.png
new file mode 100644
index 0000000..70c74ab
Binary files /dev/null and b/avian/assets/illustrations/ammodramus-savannarum.png differ
diff --git a/avian/assets/illustrations/amphispiza-bilineata.png b/avian/assets/illustrations/amphispiza-bilineata.png
new file mode 100644
index 0000000..8cef4f1
Binary files /dev/null and b/avian/assets/illustrations/amphispiza-bilineata.png differ
diff --git a/avian/assets/illustrations/anas-crecca-2.png b/avian/assets/illustrations/anas-crecca-2.png
new file mode 100644
index 0000000..9796ee6
Binary files /dev/null and b/avian/assets/illustrations/anas-crecca-2.png differ
diff --git a/avian/assets/illustrations/anas-crecca.png b/avian/assets/illustrations/anas-crecca.png
new file mode 100644
index 0000000..92254e8
Binary files /dev/null and b/avian/assets/illustrations/anas-crecca.png differ
diff --git a/avian/assets/illustrations/anas-platyrhynchos-2.png b/avian/assets/illustrations/anas-platyrhynchos-2.png
new file mode 100644
index 0000000..281ac06
Binary files /dev/null and b/avian/assets/illustrations/anas-platyrhynchos-2.png differ
diff --git a/avian/assets/illustrations/anas-platyrhynchos.png b/avian/assets/illustrations/anas-platyrhynchos.png
new file mode 100644
index 0000000..0531f24
Binary files /dev/null and b/avian/assets/illustrations/anas-platyrhynchos.png differ
diff --git a/avian/assets/illustrations/anser-albifrons-2.png b/avian/assets/illustrations/anser-albifrons-2.png
new file mode 100644
index 0000000..124bc1c
Binary files /dev/null and b/avian/assets/illustrations/anser-albifrons-2.png differ
diff --git a/avian/assets/illustrations/anser-albifrons.png b/avian/assets/illustrations/anser-albifrons.png
new file mode 100644
index 0000000..70c567a
Binary files /dev/null and b/avian/assets/illustrations/anser-albifrons.png differ
diff --git a/avian/assets/illustrations/anthus-rubescens-2.png b/avian/assets/illustrations/anthus-rubescens-2.png
new file mode 100644
index 0000000..b6d5c7b
Binary files /dev/null and b/avian/assets/illustrations/anthus-rubescens-2.png differ
diff --git a/avian/assets/illustrations/anthus-rubescens.png b/avian/assets/illustrations/anthus-rubescens.png
new file mode 100644
index 0000000..5fd710c
Binary files /dev/null and b/avian/assets/illustrations/anthus-rubescens.png differ
diff --git a/avian/assets/illustrations/aphelocoma-californica-2.png b/avian/assets/illustrations/aphelocoma-californica-2.png
new file mode 100644
index 0000000..f2c5f64
Binary files /dev/null and b/avian/assets/illustrations/aphelocoma-californica-2.png differ
diff --git a/avian/assets/illustrations/aphelocoma-californica.png b/avian/assets/illustrations/aphelocoma-californica.png
new file mode 100644
index 0000000..572bb59
Binary files /dev/null and b/avian/assets/illustrations/aphelocoma-californica.png differ
diff --git a/avian/assets/illustrations/aphelocoma-woodhouseii-2.png b/avian/assets/illustrations/aphelocoma-woodhouseii-2.png
new file mode 100644
index 0000000..55544c4
Binary files /dev/null and b/avian/assets/illustrations/aphelocoma-woodhouseii-2.png differ
diff --git a/avian/assets/illustrations/aphelocoma-woodhouseii.png b/avian/assets/illustrations/aphelocoma-woodhouseii.png
new file mode 100644
index 0000000..731be62
Binary files /dev/null and b/avian/assets/illustrations/aphelocoma-woodhouseii.png differ
diff --git a/avian/assets/illustrations/aquila-chrysaetos-2.png b/avian/assets/illustrations/aquila-chrysaetos-2.png
new file mode 100644
index 0000000..544c998
Binary files /dev/null and b/avian/assets/illustrations/aquila-chrysaetos-2.png differ
diff --git a/avian/assets/illustrations/aquila-chrysaetos.png b/avian/assets/illustrations/aquila-chrysaetos.png
new file mode 100644
index 0000000..0ab1000
Binary files /dev/null and b/avian/assets/illustrations/aquila-chrysaetos.png differ
diff --git a/avian/assets/illustrations/archilochus-alexandri-2.png b/avian/assets/illustrations/archilochus-alexandri-2.png
new file mode 100644
index 0000000..2c28e8c
Binary files /dev/null and b/avian/assets/illustrations/archilochus-alexandri-2.png differ
diff --git a/avian/assets/illustrations/archilochus-alexandri.png b/avian/assets/illustrations/archilochus-alexandri.png
new file mode 100644
index 0000000..a743173
Binary files /dev/null and b/avian/assets/illustrations/archilochus-alexandri.png differ
diff --git a/avian/assets/illustrations/ardea-alba-2.png b/avian/assets/illustrations/ardea-alba-2.png
new file mode 100644
index 0000000..add6d66
Binary files /dev/null and b/avian/assets/illustrations/ardea-alba-2.png differ
diff --git a/avian/assets/illustrations/ardea-alba.png b/avian/assets/illustrations/ardea-alba.png
new file mode 100644
index 0000000..061e47e
Binary files /dev/null and b/avian/assets/illustrations/ardea-alba.png differ
diff --git a/avian/assets/illustrations/ardea-herodias-2.png b/avian/assets/illustrations/ardea-herodias-2.png
new file mode 100644
index 0000000..8855f8f
Binary files /dev/null and b/avian/assets/illustrations/ardea-herodias-2.png differ
diff --git a/avian/assets/illustrations/ardea-herodias.png b/avian/assets/illustrations/ardea-herodias.png
new file mode 100644
index 0000000..7a156b8
Binary files /dev/null and b/avian/assets/illustrations/ardea-herodias.png differ
diff --git a/avian/assets/illustrations/artemisiospiza-belli.png b/avian/assets/illustrations/artemisiospiza-belli.png
new file mode 100644
index 0000000..70647c1
Binary files /dev/null and b/avian/assets/illustrations/artemisiospiza-belli.png differ
diff --git a/avian/assets/illustrations/asio-flammeus-2.png b/avian/assets/illustrations/asio-flammeus-2.png
new file mode 100644
index 0000000..1381401
Binary files /dev/null and b/avian/assets/illustrations/asio-flammeus-2.png differ
diff --git a/avian/assets/illustrations/asio-flammeus.png b/avian/assets/illustrations/asio-flammeus.png
new file mode 100644
index 0000000..f0524f6
Binary files /dev/null and b/avian/assets/illustrations/asio-flammeus.png differ
diff --git a/avian/assets/illustrations/asio-otus-2.png b/avian/assets/illustrations/asio-otus-2.png
new file mode 100644
index 0000000..12dbe78
Binary files /dev/null and b/avian/assets/illustrations/asio-otus-2.png differ
diff --git a/avian/assets/illustrations/asio-otus.png b/avian/assets/illustrations/asio-otus.png
new file mode 100644
index 0000000..c2e6d0b
Binary files /dev/null and b/avian/assets/illustrations/asio-otus.png differ
diff --git a/avian/assets/illustrations/athene-cunicularia-2.png b/avian/assets/illustrations/athene-cunicularia-2.png
new file mode 100644
index 0000000..2aff792
Binary files /dev/null and b/avian/assets/illustrations/athene-cunicularia-2.png differ
diff --git a/avian/assets/illustrations/athene-cunicularia.png b/avian/assets/illustrations/athene-cunicularia.png
new file mode 100644
index 0000000..14528f6
Binary files /dev/null and b/avian/assets/illustrations/athene-cunicularia.png differ
diff --git a/avian/assets/illustrations/aythya-affinis-2.png b/avian/assets/illustrations/aythya-affinis-2.png
new file mode 100644
index 0000000..1b1d863
Binary files /dev/null and b/avian/assets/illustrations/aythya-affinis-2.png differ
diff --git a/avian/assets/illustrations/aythya-affinis.png b/avian/assets/illustrations/aythya-affinis.png
new file mode 100644
index 0000000..ba4b98a
Binary files /dev/null and b/avian/assets/illustrations/aythya-affinis.png differ
diff --git a/avian/assets/illustrations/aythya-americana-2.png b/avian/assets/illustrations/aythya-americana-2.png
new file mode 100644
index 0000000..be1c9bc
Binary files /dev/null and b/avian/assets/illustrations/aythya-americana-2.png differ
diff --git a/avian/assets/illustrations/aythya-americana.png b/avian/assets/illustrations/aythya-americana.png
new file mode 100644
index 0000000..2ba3c77
Binary files /dev/null and b/avian/assets/illustrations/aythya-americana.png differ
diff --git a/avian/assets/illustrations/aythya-collaris-2.png b/avian/assets/illustrations/aythya-collaris-2.png
new file mode 100644
index 0000000..92bae99
Binary files /dev/null and b/avian/assets/illustrations/aythya-collaris-2.png differ
diff --git a/avian/assets/illustrations/aythya-collaris.png b/avian/assets/illustrations/aythya-collaris.png
new file mode 100644
index 0000000..f470610
Binary files /dev/null and b/avian/assets/illustrations/aythya-collaris.png differ
diff --git a/avian/assets/illustrations/aythya-valisineria-2.png b/avian/assets/illustrations/aythya-valisineria-2.png
new file mode 100644
index 0000000..964b90b
Binary files /dev/null and b/avian/assets/illustrations/aythya-valisineria-2.png differ
diff --git a/avian/assets/illustrations/aythya-valisineria.png b/avian/assets/illustrations/aythya-valisineria.png
new file mode 100644
index 0000000..18dd3d4
Binary files /dev/null and b/avian/assets/illustrations/aythya-valisineria.png differ
diff --git a/avian/assets/illustrations/baeolophus-inornatus-2.png b/avian/assets/illustrations/baeolophus-inornatus-2.png
new file mode 100644
index 0000000..f4c69d5
Binary files /dev/null and b/avian/assets/illustrations/baeolophus-inornatus-2.png differ
diff --git a/avian/assets/illustrations/baeolophus-inornatus.png b/avian/assets/illustrations/baeolophus-inornatus.png
new file mode 100644
index 0000000..17bd065
Binary files /dev/null and b/avian/assets/illustrations/baeolophus-inornatus.png differ
diff --git a/avian/assets/illustrations/bombycilla-cedrorum-2.png b/avian/assets/illustrations/bombycilla-cedrorum-2.png
new file mode 100644
index 0000000..7978173
Binary files /dev/null and b/avian/assets/illustrations/bombycilla-cedrorum-2.png differ
diff --git a/avian/assets/illustrations/bombycilla-cedrorum.png b/avian/assets/illustrations/bombycilla-cedrorum.png
new file mode 100644
index 0000000..31b4957
Binary files /dev/null and b/avian/assets/illustrations/bombycilla-cedrorum.png differ
diff --git a/avian/assets/illustrations/bombycilla-garrulus-2.png b/avian/assets/illustrations/bombycilla-garrulus-2.png
new file mode 100644
index 0000000..5e2368d
Binary files /dev/null and b/avian/assets/illustrations/bombycilla-garrulus-2.png differ
diff --git a/avian/assets/illustrations/bombycilla-garrulus.png b/avian/assets/illustrations/bombycilla-garrulus.png
new file mode 100644
index 0000000..43595c2
Binary files /dev/null and b/avian/assets/illustrations/bombycilla-garrulus.png differ
diff --git a/avian/assets/illustrations/branta-canadensis-2.png b/avian/assets/illustrations/branta-canadensis-2.png
new file mode 100644
index 0000000..4f0e4e7
Binary files /dev/null and b/avian/assets/illustrations/branta-canadensis-2.png differ
diff --git a/avian/assets/illustrations/branta-canadensis.png b/avian/assets/illustrations/branta-canadensis.png
new file mode 100644
index 0000000..08d4415
Binary files /dev/null and b/avian/assets/illustrations/branta-canadensis.png differ
diff --git a/avian/assets/illustrations/bubo-virginianus-2.png b/avian/assets/illustrations/bubo-virginianus-2.png
new file mode 100644
index 0000000..83a7419
Binary files /dev/null and b/avian/assets/illustrations/bubo-virginianus-2.png differ
diff --git a/avian/assets/illustrations/bubo-virginianus.png b/avian/assets/illustrations/bubo-virginianus.png
new file mode 100644
index 0000000..8984fbe
Binary files /dev/null and b/avian/assets/illustrations/bubo-virginianus.png differ
diff --git a/avian/assets/illustrations/bubulcus-ibis-2.png b/avian/assets/illustrations/bubulcus-ibis-2.png
new file mode 100644
index 0000000..8921536
Binary files /dev/null and b/avian/assets/illustrations/bubulcus-ibis-2.png differ
diff --git a/avian/assets/illustrations/bubulcus-ibis.png b/avian/assets/illustrations/bubulcus-ibis.png
new file mode 100644
index 0000000..0a431f8
Binary files /dev/null and b/avian/assets/illustrations/bubulcus-ibis.png differ
diff --git a/avian/assets/illustrations/bucephala-albeola-2.png b/avian/assets/illustrations/bucephala-albeola-2.png
new file mode 100644
index 0000000..a0721ee
Binary files /dev/null and b/avian/assets/illustrations/bucephala-albeola-2.png differ
diff --git a/avian/assets/illustrations/bucephala-albeola.png b/avian/assets/illustrations/bucephala-albeola.png
new file mode 100644
index 0000000..3e991ff
Binary files /dev/null and b/avian/assets/illustrations/bucephala-albeola.png differ
diff --git a/avian/assets/illustrations/bucephala-clangula-2.png b/avian/assets/illustrations/bucephala-clangula-2.png
new file mode 100644
index 0000000..7366e85
Binary files /dev/null and b/avian/assets/illustrations/bucephala-clangula-2.png differ
diff --git a/avian/assets/illustrations/bucephala-clangula.png b/avian/assets/illustrations/bucephala-clangula.png
new file mode 100644
index 0000000..4c11da0
Binary files /dev/null and b/avian/assets/illustrations/bucephala-clangula.png differ
diff --git a/avian/assets/illustrations/buteo-jamaicensis-2.png b/avian/assets/illustrations/buteo-jamaicensis-2.png
new file mode 100644
index 0000000..3d5c120
Binary files /dev/null and b/avian/assets/illustrations/buteo-jamaicensis-2.png differ
diff --git a/avian/assets/illustrations/buteo-jamaicensis.png b/avian/assets/illustrations/buteo-jamaicensis.png
new file mode 100644
index 0000000..e3e8ccd
Binary files /dev/null and b/avian/assets/illustrations/buteo-jamaicensis.png differ
diff --git a/avian/assets/illustrations/buteo-lagopus-2.png b/avian/assets/illustrations/buteo-lagopus-2.png
new file mode 100644
index 0000000..93b8d2e
Binary files /dev/null and b/avian/assets/illustrations/buteo-lagopus-2.png differ
diff --git a/avian/assets/illustrations/buteo-lagopus.png b/avian/assets/illustrations/buteo-lagopus.png
new file mode 100644
index 0000000..fd81b7a
Binary files /dev/null and b/avian/assets/illustrations/buteo-lagopus.png differ
diff --git a/avian/assets/illustrations/buteo-lineatus-2.png b/avian/assets/illustrations/buteo-lineatus-2.png
new file mode 100644
index 0000000..99fc37f
Binary files /dev/null and b/avian/assets/illustrations/buteo-lineatus-2.png differ
diff --git a/avian/assets/illustrations/buteo-lineatus.png b/avian/assets/illustrations/buteo-lineatus.png
new file mode 100644
index 0000000..a1be4b2
Binary files /dev/null and b/avian/assets/illustrations/buteo-lineatus.png differ
diff --git a/avian/assets/illustrations/buteo-regalis-2.png b/avian/assets/illustrations/buteo-regalis-2.png
new file mode 100644
index 0000000..992cec3
Binary files /dev/null and b/avian/assets/illustrations/buteo-regalis-2.png differ
diff --git a/avian/assets/illustrations/buteo-regalis.png b/avian/assets/illustrations/buteo-regalis.png
new file mode 100644
index 0000000..bbe31d8
Binary files /dev/null and b/avian/assets/illustrations/buteo-regalis.png differ
diff --git a/avian/assets/illustrations/buteo-swainsoni-2.png b/avian/assets/illustrations/buteo-swainsoni-2.png
new file mode 100644
index 0000000..11fd698
Binary files /dev/null and b/avian/assets/illustrations/buteo-swainsoni-2.png differ
diff --git a/avian/assets/illustrations/buteo-swainsoni.png b/avian/assets/illustrations/buteo-swainsoni.png
new file mode 100644
index 0000000..c02e446
Binary files /dev/null and b/avian/assets/illustrations/buteo-swainsoni.png differ
diff --git a/avian/assets/illustrations/butorides-virescens-2.png b/avian/assets/illustrations/butorides-virescens-2.png
new file mode 100644
index 0000000..51be5ec
Binary files /dev/null and b/avian/assets/illustrations/butorides-virescens-2.png differ
diff --git a/avian/assets/illustrations/butorides-virescens.png b/avian/assets/illustrations/butorides-virescens.png
new file mode 100644
index 0000000..1a2362d
Binary files /dev/null and b/avian/assets/illustrations/butorides-virescens.png differ
diff --git a/avian/assets/illustrations/calamospiza-melanocorys.png b/avian/assets/illustrations/calamospiza-melanocorys.png
new file mode 100644
index 0000000..c9996e1
Binary files /dev/null and b/avian/assets/illustrations/calamospiza-melanocorys.png differ
diff --git a/avian/assets/illustrations/calidris-alba-2.png b/avian/assets/illustrations/calidris-alba-2.png
new file mode 100644
index 0000000..a35ef86
Binary files /dev/null and b/avian/assets/illustrations/calidris-alba-2.png differ
diff --git a/avian/assets/illustrations/calidris-alba.png b/avian/assets/illustrations/calidris-alba.png
new file mode 100644
index 0000000..6673a9b
Binary files /dev/null and b/avian/assets/illustrations/calidris-alba.png differ
diff --git a/avian/assets/illustrations/calidris-alpina-2.png b/avian/assets/illustrations/calidris-alpina-2.png
new file mode 100644
index 0000000..f9d7903
Binary files /dev/null and b/avian/assets/illustrations/calidris-alpina-2.png differ
diff --git a/avian/assets/illustrations/calidris-alpina.png b/avian/assets/illustrations/calidris-alpina.png
new file mode 100644
index 0000000..acb4eb6
Binary files /dev/null and b/avian/assets/illustrations/calidris-alpina.png differ
diff --git a/avian/assets/illustrations/callipepla-californica-2.png b/avian/assets/illustrations/callipepla-californica-2.png
new file mode 100644
index 0000000..498636c
Binary files /dev/null and b/avian/assets/illustrations/callipepla-californica-2.png differ
diff --git a/avian/assets/illustrations/callipepla-californica.png b/avian/assets/illustrations/callipepla-californica.png
new file mode 100644
index 0000000..f89c51a
Binary files /dev/null and b/avian/assets/illustrations/callipepla-californica.png differ
diff --git a/avian/assets/illustrations/calothorax-lucifer.png b/avian/assets/illustrations/calothorax-lucifer.png
new file mode 100644
index 0000000..6d5ad96
Binary files /dev/null and b/avian/assets/illustrations/calothorax-lucifer.png differ
diff --git a/avian/assets/illustrations/calypte-anna-2.png b/avian/assets/illustrations/calypte-anna-2.png
new file mode 100644
index 0000000..d3ed00f
Binary files /dev/null and b/avian/assets/illustrations/calypte-anna-2.png differ
diff --git a/avian/assets/illustrations/calypte-anna.png b/avian/assets/illustrations/calypte-anna.png
new file mode 100644
index 0000000..036a9c9
Binary files /dev/null and b/avian/assets/illustrations/calypte-anna.png differ
diff --git a/avian/assets/illustrations/calypte-costae-2.png b/avian/assets/illustrations/calypte-costae-2.png
new file mode 100644
index 0000000..227cff3
Binary files /dev/null and b/avian/assets/illustrations/calypte-costae-2.png differ
diff --git a/avian/assets/illustrations/calypte-costae.png b/avian/assets/illustrations/calypte-costae.png
new file mode 100644
index 0000000..a7e3573
Binary files /dev/null and b/avian/assets/illustrations/calypte-costae.png differ
diff --git a/avian/assets/illustrations/cardellina-pusilla.png b/avian/assets/illustrations/cardellina-pusilla.png
new file mode 100644
index 0000000..7969dff
Binary files /dev/null and b/avian/assets/illustrations/cardellina-pusilla.png differ
diff --git a/avian/assets/illustrations/cardellina-rubrifrons-2.png b/avian/assets/illustrations/cardellina-rubrifrons-2.png
new file mode 100644
index 0000000..07b2b85
Binary files /dev/null and b/avian/assets/illustrations/cardellina-rubrifrons-2.png differ
diff --git a/avian/assets/illustrations/cardellina-rubrifrons.png b/avian/assets/illustrations/cardellina-rubrifrons.png
new file mode 100644
index 0000000..3617821
Binary files /dev/null and b/avian/assets/illustrations/cardellina-rubrifrons.png differ
diff --git a/avian/assets/illustrations/cathartes-aura-2.png b/avian/assets/illustrations/cathartes-aura-2.png
new file mode 100644
index 0000000..8f5cc87
Binary files /dev/null and b/avian/assets/illustrations/cathartes-aura-2.png differ
diff --git a/avian/assets/illustrations/cathartes-aura.png b/avian/assets/illustrations/cathartes-aura.png
new file mode 100644
index 0000000..d73f8f3
Binary files /dev/null and b/avian/assets/illustrations/cathartes-aura.png differ
diff --git a/avian/assets/illustrations/catharus-guttatus-2.png b/avian/assets/illustrations/catharus-guttatus-2.png
new file mode 100644
index 0000000..ef9e308
Binary files /dev/null and b/avian/assets/illustrations/catharus-guttatus-2.png differ
diff --git a/avian/assets/illustrations/catharus-guttatus.png b/avian/assets/illustrations/catharus-guttatus.png
new file mode 100644
index 0000000..b19c73a
Binary files /dev/null and b/avian/assets/illustrations/catharus-guttatus.png differ
diff --git a/avian/assets/illustrations/catharus-ustulatus.png b/avian/assets/illustrations/catharus-ustulatus.png
new file mode 100644
index 0000000..8a6e69e
Binary files /dev/null and b/avian/assets/illustrations/catharus-ustulatus.png differ
diff --git a/avian/assets/illustrations/catherpes-mexicanus-2.png b/avian/assets/illustrations/catherpes-mexicanus-2.png
new file mode 100644
index 0000000..759c500
Binary files /dev/null and b/avian/assets/illustrations/catherpes-mexicanus-2.png differ
diff --git a/avian/assets/illustrations/catherpes-mexicanus.png b/avian/assets/illustrations/catherpes-mexicanus.png
new file mode 100644
index 0000000..2e5bf00
Binary files /dev/null and b/avian/assets/illustrations/catherpes-mexicanus.png differ
diff --git a/avian/assets/illustrations/certhia-americana-2.png b/avian/assets/illustrations/certhia-americana-2.png
new file mode 100644
index 0000000..6617316
Binary files /dev/null and b/avian/assets/illustrations/certhia-americana-2.png differ
diff --git a/avian/assets/illustrations/certhia-americana.png b/avian/assets/illustrations/certhia-americana.png
new file mode 100644
index 0000000..6e7c660
Binary files /dev/null and b/avian/assets/illustrations/certhia-americana.png differ
diff --git a/avian/assets/illustrations/chaetura-vauxi-2.png b/avian/assets/illustrations/chaetura-vauxi-2.png
new file mode 100644
index 0000000..1032d02
Binary files /dev/null and b/avian/assets/illustrations/chaetura-vauxi-2.png differ
diff --git a/avian/assets/illustrations/chaetura-vauxi.png b/avian/assets/illustrations/chaetura-vauxi.png
new file mode 100644
index 0000000..b61c892
Binary files /dev/null and b/avian/assets/illustrations/chaetura-vauxi.png differ
diff --git a/avian/assets/illustrations/charadrius-vociferus-2.png b/avian/assets/illustrations/charadrius-vociferus-2.png
new file mode 100644
index 0000000..caa5e12
Binary files /dev/null and b/avian/assets/illustrations/charadrius-vociferus-2.png differ
diff --git a/avian/assets/illustrations/charadrius-vociferus.png b/avian/assets/illustrations/charadrius-vociferus.png
new file mode 100644
index 0000000..9a8497a
Binary files /dev/null and b/avian/assets/illustrations/charadrius-vociferus.png differ
diff --git a/avian/assets/illustrations/chondestes-grammacus.png b/avian/assets/illustrations/chondestes-grammacus.png
new file mode 100644
index 0000000..985a54f
Binary files /dev/null and b/avian/assets/illustrations/chondestes-grammacus.png differ
diff --git a/avian/assets/illustrations/chordeiles-minor-2.png b/avian/assets/illustrations/chordeiles-minor-2.png
new file mode 100644
index 0000000..6da51c7
Binary files /dev/null and b/avian/assets/illustrations/chordeiles-minor-2.png differ
diff --git a/avian/assets/illustrations/chordeiles-minor.png b/avian/assets/illustrations/chordeiles-minor.png
new file mode 100644
index 0000000..cf50d09
Binary files /dev/null and b/avian/assets/illustrations/chordeiles-minor.png differ
diff --git a/avian/assets/illustrations/cinclus-mexicanus-2.png b/avian/assets/illustrations/cinclus-mexicanus-2.png
new file mode 100644
index 0000000..6f20c64
Binary files /dev/null and b/avian/assets/illustrations/cinclus-mexicanus-2.png differ
diff --git a/avian/assets/illustrations/cinclus-mexicanus.png b/avian/assets/illustrations/cinclus-mexicanus.png
new file mode 100644
index 0000000..feec627
Binary files /dev/null and b/avian/assets/illustrations/cinclus-mexicanus.png differ
diff --git a/avian/assets/illustrations/circus-hudsonius-2.png b/avian/assets/illustrations/circus-hudsonius-2.png
new file mode 100644
index 0000000..f5e8895
Binary files /dev/null and b/avian/assets/illustrations/circus-hudsonius-2.png differ
diff --git a/avian/assets/illustrations/circus-hudsonius.png b/avian/assets/illustrations/circus-hudsonius.png
new file mode 100644
index 0000000..c4188dd
Binary files /dev/null and b/avian/assets/illustrations/circus-hudsonius.png differ
diff --git a/avian/assets/illustrations/cistothorus-palustris-2.png b/avian/assets/illustrations/cistothorus-palustris-2.png
new file mode 100644
index 0000000..a501dde
Binary files /dev/null and b/avian/assets/illustrations/cistothorus-palustris-2.png differ
diff --git a/avian/assets/illustrations/cistothorus-palustris.png b/avian/assets/illustrations/cistothorus-palustris.png
new file mode 100644
index 0000000..406777a
Binary files /dev/null and b/avian/assets/illustrations/cistothorus-palustris.png differ
diff --git a/avian/assets/illustrations/coccothraustes-vespertinus-2.png b/avian/assets/illustrations/coccothraustes-vespertinus-2.png
new file mode 100644
index 0000000..eb98a3e
Binary files /dev/null and b/avian/assets/illustrations/coccothraustes-vespertinus-2.png differ
diff --git a/avian/assets/illustrations/coccothraustes-vespertinus.png b/avian/assets/illustrations/coccothraustes-vespertinus.png
new file mode 100644
index 0000000..0720438
Binary files /dev/null and b/avian/assets/illustrations/coccothraustes-vespertinus.png differ
diff --git a/avian/assets/illustrations/colaptes-auratus-2.png b/avian/assets/illustrations/colaptes-auratus-2.png
new file mode 100644
index 0000000..59df1ea
Binary files /dev/null and b/avian/assets/illustrations/colaptes-auratus-2.png differ
diff --git a/avian/assets/illustrations/colaptes-auratus.png b/avian/assets/illustrations/colaptes-auratus.png
new file mode 100644
index 0000000..8ab686d
Binary files /dev/null and b/avian/assets/illustrations/colaptes-auratus.png differ
diff --git a/avian/assets/illustrations/columba-livia-2.png b/avian/assets/illustrations/columba-livia-2.png
new file mode 100644
index 0000000..ff2c4c3
Binary files /dev/null and b/avian/assets/illustrations/columba-livia-2.png differ
diff --git a/avian/assets/illustrations/columba-livia.png b/avian/assets/illustrations/columba-livia.png
new file mode 100644
index 0000000..4446987
Binary files /dev/null and b/avian/assets/illustrations/columba-livia.png differ
diff --git a/avian/assets/illustrations/columbina-passerina-2.png b/avian/assets/illustrations/columbina-passerina-2.png
new file mode 100644
index 0000000..fdaacf5
Binary files /dev/null and b/avian/assets/illustrations/columbina-passerina-2.png differ
diff --git a/avian/assets/illustrations/columbina-passerina.png b/avian/assets/illustrations/columbina-passerina.png
new file mode 100644
index 0000000..204e3ea
Binary files /dev/null and b/avian/assets/illustrations/columbina-passerina.png differ
diff --git a/avian/assets/illustrations/contopus-sordidulus.png b/avian/assets/illustrations/contopus-sordidulus.png
new file mode 100644
index 0000000..0f6bccf
Binary files /dev/null and b/avian/assets/illustrations/contopus-sordidulus.png differ
diff --git a/avian/assets/illustrations/coragyps-atratus-2.png b/avian/assets/illustrations/coragyps-atratus-2.png
new file mode 100644
index 0000000..2ace13e
Binary files /dev/null and b/avian/assets/illustrations/coragyps-atratus-2.png differ
diff --git a/avian/assets/illustrations/coragyps-atratus.png b/avian/assets/illustrations/coragyps-atratus.png
new file mode 100644
index 0000000..3f3ca8a
Binary files /dev/null and b/avian/assets/illustrations/coragyps-atratus.png differ
diff --git a/avian/assets/illustrations/corvus-brachyrhynchos-2.png b/avian/assets/illustrations/corvus-brachyrhynchos-2.png
new file mode 100644
index 0000000..c05825c
Binary files /dev/null and b/avian/assets/illustrations/corvus-brachyrhynchos-2.png differ
diff --git a/avian/assets/illustrations/corvus-brachyrhynchos.png b/avian/assets/illustrations/corvus-brachyrhynchos.png
new file mode 100644
index 0000000..fcae7ea
Binary files /dev/null and b/avian/assets/illustrations/corvus-brachyrhynchos.png differ
diff --git a/avian/assets/illustrations/corvus-corax-2.png b/avian/assets/illustrations/corvus-corax-2.png
new file mode 100644
index 0000000..20f09b6
Binary files /dev/null and b/avian/assets/illustrations/corvus-corax-2.png differ
diff --git a/avian/assets/illustrations/corvus-corax.png b/avian/assets/illustrations/corvus-corax.png
new file mode 100644
index 0000000..ab1c970
Binary files /dev/null and b/avian/assets/illustrations/corvus-corax.png differ
diff --git a/avian/assets/illustrations/cyanocitta-stelleri-2.png b/avian/assets/illustrations/cyanocitta-stelleri-2.png
new file mode 100644
index 0000000..dfe8cca
Binary files /dev/null and b/avian/assets/illustrations/cyanocitta-stelleri-2.png differ
diff --git a/avian/assets/illustrations/cyanocitta-stelleri.png b/avian/assets/illustrations/cyanocitta-stelleri.png
new file mode 100644
index 0000000..3331083
Binary files /dev/null and b/avian/assets/illustrations/cyanocitta-stelleri.png differ
diff --git a/avian/assets/illustrations/cygnus-buccinator-2.png b/avian/assets/illustrations/cygnus-buccinator-2.png
new file mode 100644
index 0000000..ca1549c
Binary files /dev/null and b/avian/assets/illustrations/cygnus-buccinator-2.png differ
diff --git a/avian/assets/illustrations/cygnus-buccinator.png b/avian/assets/illustrations/cygnus-buccinator.png
new file mode 100644
index 0000000..81a7d20
Binary files /dev/null and b/avian/assets/illustrations/cygnus-buccinator.png differ
diff --git a/avian/assets/illustrations/cypseloides-niger-2.png b/avian/assets/illustrations/cypseloides-niger-2.png
new file mode 100644
index 0000000..62d98cc
Binary files /dev/null and b/avian/assets/illustrations/cypseloides-niger-2.png differ
diff --git a/avian/assets/illustrations/cypseloides-niger.png b/avian/assets/illustrations/cypseloides-niger.png
new file mode 100644
index 0000000..d04b014
Binary files /dev/null and b/avian/assets/illustrations/cypseloides-niger.png differ
diff --git a/avian/assets/illustrations/dryobates-nuttallii.png b/avian/assets/illustrations/dryobates-nuttallii.png
new file mode 100644
index 0000000..8efc1cb
Binary files /dev/null and b/avian/assets/illustrations/dryobates-nuttallii.png differ
diff --git a/avian/assets/illustrations/dryobates-pubescens-2.png b/avian/assets/illustrations/dryobates-pubescens-2.png
new file mode 100644
index 0000000..8d0bdb5
Binary files /dev/null and b/avian/assets/illustrations/dryobates-pubescens-2.png differ
diff --git a/avian/assets/illustrations/dryobates-pubescens.png b/avian/assets/illustrations/dryobates-pubescens.png
new file mode 100644
index 0000000..6141928
Binary files /dev/null and b/avian/assets/illustrations/dryobates-pubescens.png differ
diff --git a/avian/assets/illustrations/dryobates-villosus-2.png b/avian/assets/illustrations/dryobates-villosus-2.png
new file mode 100644
index 0000000..2baf40d
Binary files /dev/null and b/avian/assets/illustrations/dryobates-villosus-2.png differ
diff --git a/avian/assets/illustrations/dryobates-villosus.png b/avian/assets/illustrations/dryobates-villosus.png
new file mode 100644
index 0000000..695c935
Binary files /dev/null and b/avian/assets/illustrations/dryobates-villosus.png differ
diff --git a/avian/assets/illustrations/dryocopus-pileatus-2.png b/avian/assets/illustrations/dryocopus-pileatus-2.png
new file mode 100644
index 0000000..55fce86
Binary files /dev/null and b/avian/assets/illustrations/dryocopus-pileatus-2.png differ
diff --git a/avian/assets/illustrations/dryocopus-pileatus.png b/avian/assets/illustrations/dryocopus-pileatus.png
new file mode 100644
index 0000000..025d0d0
Binary files /dev/null and b/avian/assets/illustrations/dryocopus-pileatus.png differ
diff --git a/avian/assets/illustrations/egretta-caerulea-2.png b/avian/assets/illustrations/egretta-caerulea-2.png
new file mode 100644
index 0000000..dcecb45
Binary files /dev/null and b/avian/assets/illustrations/egretta-caerulea-2.png differ
diff --git a/avian/assets/illustrations/egretta-caerulea.png b/avian/assets/illustrations/egretta-caerulea.png
new file mode 100644
index 0000000..f0d0121
Binary files /dev/null and b/avian/assets/illustrations/egretta-caerulea.png differ
diff --git a/avian/assets/illustrations/egretta-thula-2.png b/avian/assets/illustrations/egretta-thula-2.png
new file mode 100644
index 0000000..c492b00
Binary files /dev/null and b/avian/assets/illustrations/egretta-thula-2.png differ
diff --git a/avian/assets/illustrations/egretta-thula.png b/avian/assets/illustrations/egretta-thula.png
new file mode 100644
index 0000000..495feac
Binary files /dev/null and b/avian/assets/illustrations/egretta-thula.png differ
diff --git a/avian/assets/illustrations/elanus-leucurus-2.png b/avian/assets/illustrations/elanus-leucurus-2.png
new file mode 100644
index 0000000..4b5b562
Binary files /dev/null and b/avian/assets/illustrations/elanus-leucurus-2.png differ
diff --git a/avian/assets/illustrations/elanus-leucurus.png b/avian/assets/illustrations/elanus-leucurus.png
new file mode 100644
index 0000000..21c82b2
Binary files /dev/null and b/avian/assets/illustrations/elanus-leucurus.png differ
diff --git a/avian/assets/illustrations/empidonax-difficilis.png b/avian/assets/illustrations/empidonax-difficilis.png
new file mode 100644
index 0000000..9d0bf36
Binary files /dev/null and b/avian/assets/illustrations/empidonax-difficilis.png differ
diff --git a/avian/assets/illustrations/empidonax-hammondii-2.png b/avian/assets/illustrations/empidonax-hammondii-2.png
new file mode 100644
index 0000000..0538241
Binary files /dev/null and b/avian/assets/illustrations/empidonax-hammondii-2.png differ
diff --git a/avian/assets/illustrations/empidonax-hammondii.png b/avian/assets/illustrations/empidonax-hammondii.png
new file mode 100644
index 0000000..79c1449
Binary files /dev/null and b/avian/assets/illustrations/empidonax-hammondii.png differ
diff --git a/avian/assets/illustrations/empidonax-oberholseri-2.png b/avian/assets/illustrations/empidonax-oberholseri-2.png
new file mode 100644
index 0000000..b1a4d5f
Binary files /dev/null and b/avian/assets/illustrations/empidonax-oberholseri-2.png differ
diff --git a/avian/assets/illustrations/empidonax-oberholseri.png b/avian/assets/illustrations/empidonax-oberholseri.png
new file mode 100644
index 0000000..5ae7a1d
Binary files /dev/null and b/avian/assets/illustrations/empidonax-oberholseri.png differ
diff --git a/avian/assets/illustrations/empidonax-traillii-2.png b/avian/assets/illustrations/empidonax-traillii-2.png
new file mode 100644
index 0000000..5e57307
Binary files /dev/null and b/avian/assets/illustrations/empidonax-traillii-2.png differ
diff --git a/avian/assets/illustrations/empidonax-traillii.png b/avian/assets/illustrations/empidonax-traillii.png
new file mode 100644
index 0000000..eb9b5aa
Binary files /dev/null and b/avian/assets/illustrations/empidonax-traillii.png differ
diff --git a/avian/assets/illustrations/empidonax-wrightii-2.png b/avian/assets/illustrations/empidonax-wrightii-2.png
new file mode 100644
index 0000000..a740f99
Binary files /dev/null and b/avian/assets/illustrations/empidonax-wrightii-2.png differ
diff --git a/avian/assets/illustrations/empidonax-wrightii.png b/avian/assets/illustrations/empidonax-wrightii.png
new file mode 100644
index 0000000..89f95c5
Binary files /dev/null and b/avian/assets/illustrations/empidonax-wrightii.png differ
diff --git a/avian/assets/illustrations/eremophila-alpestris.png b/avian/assets/illustrations/eremophila-alpestris.png
new file mode 100644
index 0000000..00130c1
Binary files /dev/null and b/avian/assets/illustrations/eremophila-alpestris.png differ
diff --git a/avian/assets/illustrations/euphagus-cyanocephalus-2.png b/avian/assets/illustrations/euphagus-cyanocephalus-2.png
new file mode 100644
index 0000000..59260ee
Binary files /dev/null and b/avian/assets/illustrations/euphagus-cyanocephalus-2.png differ
diff --git a/avian/assets/illustrations/euphagus-cyanocephalus.png b/avian/assets/illustrations/euphagus-cyanocephalus.png
new file mode 100644
index 0000000..0394ea3
Binary files /dev/null and b/avian/assets/illustrations/euphagus-cyanocephalus.png differ
diff --git a/avian/assets/illustrations/falco-columbarius-2.png b/avian/assets/illustrations/falco-columbarius-2.png
new file mode 100644
index 0000000..4b66cc7
Binary files /dev/null and b/avian/assets/illustrations/falco-columbarius-2.png differ
diff --git a/avian/assets/illustrations/falco-columbarius.png b/avian/assets/illustrations/falco-columbarius.png
new file mode 100644
index 0000000..7255340
Binary files /dev/null and b/avian/assets/illustrations/falco-columbarius.png differ
diff --git a/avian/assets/illustrations/falco-mexicanus-2.png b/avian/assets/illustrations/falco-mexicanus-2.png
new file mode 100644
index 0000000..a17ffa4
Binary files /dev/null and b/avian/assets/illustrations/falco-mexicanus-2.png differ
diff --git a/avian/assets/illustrations/falco-mexicanus.png b/avian/assets/illustrations/falco-mexicanus.png
new file mode 100644
index 0000000..b82f103
Binary files /dev/null and b/avian/assets/illustrations/falco-mexicanus.png differ
diff --git a/avian/assets/illustrations/falco-peregrinus-2.png b/avian/assets/illustrations/falco-peregrinus-2.png
new file mode 100644
index 0000000..a18721e
Binary files /dev/null and b/avian/assets/illustrations/falco-peregrinus-2.png differ
diff --git a/avian/assets/illustrations/falco-peregrinus.png b/avian/assets/illustrations/falco-peregrinus.png
new file mode 100644
index 0000000..7e1ea1a
Binary files /dev/null and b/avian/assets/illustrations/falco-peregrinus.png differ
diff --git a/avian/assets/illustrations/falco-sparverius-2.png b/avian/assets/illustrations/falco-sparverius-2.png
new file mode 100644
index 0000000..e4bdda1
Binary files /dev/null and b/avian/assets/illustrations/falco-sparverius-2.png differ
diff --git a/avian/assets/illustrations/falco-sparverius.png b/avian/assets/illustrations/falco-sparverius.png
new file mode 100644
index 0000000..1b4f12e
Binary files /dev/null and b/avian/assets/illustrations/falco-sparverius.png differ
diff --git a/avian/assets/illustrations/gavia-immer-2.png b/avian/assets/illustrations/gavia-immer-2.png
new file mode 100644
index 0000000..693da3e
Binary files /dev/null and b/avian/assets/illustrations/gavia-immer-2.png differ
diff --git a/avian/assets/illustrations/gavia-immer.png b/avian/assets/illustrations/gavia-immer.png
new file mode 100644
index 0000000..0350134
Binary files /dev/null and b/avian/assets/illustrations/gavia-immer.png differ
diff --git a/avian/assets/illustrations/geothlypis-tolmiei.png b/avian/assets/illustrations/geothlypis-tolmiei.png
new file mode 100644
index 0000000..ff9d293
Binary files /dev/null and b/avian/assets/illustrations/geothlypis-tolmiei.png differ
diff --git a/avian/assets/illustrations/geothlypis-trichas-2.png b/avian/assets/illustrations/geothlypis-trichas-2.png
new file mode 100644
index 0000000..4fb20a8
Binary files /dev/null and b/avian/assets/illustrations/geothlypis-trichas-2.png differ
diff --git a/avian/assets/illustrations/geothlypis-trichas.png b/avian/assets/illustrations/geothlypis-trichas.png
new file mode 100644
index 0000000..3a1e5af
Binary files /dev/null and b/avian/assets/illustrations/geothlypis-trichas.png differ
diff --git a/avian/assets/illustrations/glaucidium-gnoma-2.png b/avian/assets/illustrations/glaucidium-gnoma-2.png
new file mode 100644
index 0000000..f4554ce
Binary files /dev/null and b/avian/assets/illustrations/glaucidium-gnoma-2.png differ
diff --git a/avian/assets/illustrations/glaucidium-gnoma.png b/avian/assets/illustrations/glaucidium-gnoma.png
new file mode 100644
index 0000000..74dc7bc
Binary files /dev/null and b/avian/assets/illustrations/glaucidium-gnoma.png differ
diff --git a/avian/assets/illustrations/gymnogyps-californianus-2.png b/avian/assets/illustrations/gymnogyps-californianus-2.png
new file mode 100644
index 0000000..c63ebc1
Binary files /dev/null and b/avian/assets/illustrations/gymnogyps-californianus-2.png differ
diff --git a/avian/assets/illustrations/gymnogyps-californianus.png b/avian/assets/illustrations/gymnogyps-californianus.png
new file mode 100644
index 0000000..553984c
Binary files /dev/null and b/avian/assets/illustrations/gymnogyps-californianus.png differ
diff --git a/avian/assets/illustrations/haemorhous-mexicanus-2.png b/avian/assets/illustrations/haemorhous-mexicanus-2.png
new file mode 100644
index 0000000..0af9581
Binary files /dev/null and b/avian/assets/illustrations/haemorhous-mexicanus-2.png differ
diff --git a/avian/assets/illustrations/haemorhous-mexicanus.png b/avian/assets/illustrations/haemorhous-mexicanus.png
new file mode 100644
index 0000000..467c630
Binary files /dev/null and b/avian/assets/illustrations/haemorhous-mexicanus.png differ
diff --git a/avian/assets/illustrations/haemorhous-purpureus-2.png b/avian/assets/illustrations/haemorhous-purpureus-2.png
new file mode 100644
index 0000000..23eee9a
Binary files /dev/null and b/avian/assets/illustrations/haemorhous-purpureus-2.png differ
diff --git a/avian/assets/illustrations/haemorhous-purpureus.png b/avian/assets/illustrations/haemorhous-purpureus.png
new file mode 100644
index 0000000..10455a8
Binary files /dev/null and b/avian/assets/illustrations/haemorhous-purpureus.png differ
diff --git a/avian/assets/illustrations/haliaeetus-leucocephalus-2.png b/avian/assets/illustrations/haliaeetus-leucocephalus-2.png
new file mode 100644
index 0000000..78231ce
Binary files /dev/null and b/avian/assets/illustrations/haliaeetus-leucocephalus-2.png differ
diff --git a/avian/assets/illustrations/haliaeetus-leucocephalus.png b/avian/assets/illustrations/haliaeetus-leucocephalus.png
new file mode 100644
index 0000000..ed5f22a
Binary files /dev/null and b/avian/assets/illustrations/haliaeetus-leucocephalus.png differ
diff --git a/avian/assets/illustrations/himantopus-mexicanus-2.png b/avian/assets/illustrations/himantopus-mexicanus-2.png
new file mode 100644
index 0000000..3e1fdb7
Binary files /dev/null and b/avian/assets/illustrations/himantopus-mexicanus-2.png differ
diff --git a/avian/assets/illustrations/himantopus-mexicanus.png b/avian/assets/illustrations/himantopus-mexicanus.png
new file mode 100644
index 0000000..016274f
Binary files /dev/null and b/avian/assets/illustrations/himantopus-mexicanus.png differ
diff --git a/avian/assets/illustrations/hirundo-rustica-2.png b/avian/assets/illustrations/hirundo-rustica-2.png
new file mode 100644
index 0000000..281c18b
Binary files /dev/null and b/avian/assets/illustrations/hirundo-rustica-2.png differ
diff --git a/avian/assets/illustrations/hirundo-rustica.png b/avian/assets/illustrations/hirundo-rustica.png
new file mode 100644
index 0000000..ab70a6f
Binary files /dev/null and b/avian/assets/illustrations/hirundo-rustica.png differ
diff --git a/avian/assets/illustrations/hydroprogne-caspia-2.png b/avian/assets/illustrations/hydroprogne-caspia-2.png
new file mode 100644
index 0000000..b2002a8
Binary files /dev/null and b/avian/assets/illustrations/hydroprogne-caspia-2.png differ
diff --git a/avian/assets/illustrations/hydroprogne-caspia.png b/avian/assets/illustrations/hydroprogne-caspia.png
new file mode 100644
index 0000000..6e9e702
Binary files /dev/null and b/avian/assets/illustrations/hydroprogne-caspia.png differ
diff --git a/avian/assets/illustrations/icteria-virens.png b/avian/assets/illustrations/icteria-virens.png
new file mode 100644
index 0000000..c97a715
Binary files /dev/null and b/avian/assets/illustrations/icteria-virens.png differ
diff --git a/avian/assets/illustrations/icterus-bullockii-2.png b/avian/assets/illustrations/icterus-bullockii-2.png
new file mode 100644
index 0000000..d72d190
Binary files /dev/null and b/avian/assets/illustrations/icterus-bullockii-2.png differ
diff --git a/avian/assets/illustrations/icterus-bullockii.png b/avian/assets/illustrations/icterus-bullockii.png
new file mode 100644
index 0000000..d807166
Binary files /dev/null and b/avian/assets/illustrations/icterus-bullockii.png differ
diff --git a/avian/assets/illustrations/icterus-cucullatus-2.png b/avian/assets/illustrations/icterus-cucullatus-2.png
new file mode 100644
index 0000000..a37226e
Binary files /dev/null and b/avian/assets/illustrations/icterus-cucullatus-2.png differ
diff --git a/avian/assets/illustrations/icterus-cucullatus.png b/avian/assets/illustrations/icterus-cucullatus.png
new file mode 100644
index 0000000..bafb4ff
Binary files /dev/null and b/avian/assets/illustrations/icterus-cucullatus.png differ
diff --git a/avian/assets/illustrations/icterus-galbula-2.png b/avian/assets/illustrations/icterus-galbula-2.png
new file mode 100644
index 0000000..779a595
Binary files /dev/null and b/avian/assets/illustrations/icterus-galbula-2.png differ
diff --git a/avian/assets/illustrations/icterus-galbula.png b/avian/assets/illustrations/icterus-galbula.png
new file mode 100644
index 0000000..2a37370
Binary files /dev/null and b/avian/assets/illustrations/icterus-galbula.png differ
diff --git a/avian/assets/illustrations/icterus-parisorum-2.png b/avian/assets/illustrations/icterus-parisorum-2.png
new file mode 100644
index 0000000..a821b1b
Binary files /dev/null and b/avian/assets/illustrations/icterus-parisorum-2.png differ
diff --git a/avian/assets/illustrations/icterus-parisorum.png b/avian/assets/illustrations/icterus-parisorum.png
new file mode 100644
index 0000000..df1d432
Binary files /dev/null and b/avian/assets/illustrations/icterus-parisorum.png differ
diff --git a/avian/assets/illustrations/ixoreus-naevius-2.png b/avian/assets/illustrations/ixoreus-naevius-2.png
new file mode 100644
index 0000000..ebe73a7
Binary files /dev/null and b/avian/assets/illustrations/ixoreus-naevius-2.png differ
diff --git a/avian/assets/illustrations/ixoreus-naevius.png b/avian/assets/illustrations/ixoreus-naevius.png
new file mode 100644
index 0000000..a980be7
Binary files /dev/null and b/avian/assets/illustrations/ixoreus-naevius.png differ
diff --git a/avian/assets/illustrations/junco-hyemalis-2.png b/avian/assets/illustrations/junco-hyemalis-2.png
new file mode 100644
index 0000000..61bdac5
Binary files /dev/null and b/avian/assets/illustrations/junco-hyemalis-2.png differ
diff --git a/avian/assets/illustrations/junco-hyemalis.png b/avian/assets/illustrations/junco-hyemalis.png
new file mode 100644
index 0000000..a7e1906
Binary files /dev/null and b/avian/assets/illustrations/junco-hyemalis.png differ
diff --git a/avian/assets/illustrations/lanius-ludovicianus-2.png b/avian/assets/illustrations/lanius-ludovicianus-2.png
new file mode 100644
index 0000000..eb64cd1
Binary files /dev/null and b/avian/assets/illustrations/lanius-ludovicianus-2.png differ
diff --git a/avian/assets/illustrations/lanius-ludovicianus.png b/avian/assets/illustrations/lanius-ludovicianus.png
new file mode 100644
index 0000000..440846d
Binary files /dev/null and b/avian/assets/illustrations/lanius-ludovicianus.png differ
diff --git a/avian/assets/illustrations/larus-californicus-2.png b/avian/assets/illustrations/larus-californicus-2.png
new file mode 100644
index 0000000..24daab8
Binary files /dev/null and b/avian/assets/illustrations/larus-californicus-2.png differ
diff --git a/avian/assets/illustrations/larus-californicus.png b/avian/assets/illustrations/larus-californicus.png
new file mode 100644
index 0000000..03f6ed2
Binary files /dev/null and b/avian/assets/illustrations/larus-californicus.png differ
diff --git a/avian/assets/illustrations/larus-delawarensis-2.png b/avian/assets/illustrations/larus-delawarensis-2.png
new file mode 100644
index 0000000..d1f0db4
Binary files /dev/null and b/avian/assets/illustrations/larus-delawarensis-2.png differ
diff --git a/avian/assets/illustrations/larus-delawarensis.png b/avian/assets/illustrations/larus-delawarensis.png
new file mode 100644
index 0000000..13eecbe
Binary files /dev/null and b/avian/assets/illustrations/larus-delawarensis.png differ
diff --git a/avian/assets/illustrations/larus-glaucescens-2.png b/avian/assets/illustrations/larus-glaucescens-2.png
new file mode 100644
index 0000000..0d941e8
Binary files /dev/null and b/avian/assets/illustrations/larus-glaucescens-2.png differ
diff --git a/avian/assets/illustrations/larus-glaucescens.png b/avian/assets/illustrations/larus-glaucescens.png
new file mode 100644
index 0000000..0ccd431
Binary files /dev/null and b/avian/assets/illustrations/larus-glaucescens.png differ
diff --git a/avian/assets/illustrations/larus-heermanni-2.png b/avian/assets/illustrations/larus-heermanni-2.png
new file mode 100644
index 0000000..046c297
Binary files /dev/null and b/avian/assets/illustrations/larus-heermanni-2.png differ
diff --git a/avian/assets/illustrations/larus-heermanni.png b/avian/assets/illustrations/larus-heermanni.png
new file mode 100644
index 0000000..1325630
Binary files /dev/null and b/avian/assets/illustrations/larus-heermanni.png differ
diff --git a/avian/assets/illustrations/larus-occidentalis-2.png b/avian/assets/illustrations/larus-occidentalis-2.png
new file mode 100644
index 0000000..703fbf7
Binary files /dev/null and b/avian/assets/illustrations/larus-occidentalis-2.png differ
diff --git a/avian/assets/illustrations/larus-occidentalis.png b/avian/assets/illustrations/larus-occidentalis.png
new file mode 100644
index 0000000..f086af2
Binary files /dev/null and b/avian/assets/illustrations/larus-occidentalis.png differ
diff --git a/avian/assets/illustrations/leiothlypis-celata.png b/avian/assets/illustrations/leiothlypis-celata.png
new file mode 100644
index 0000000..60a6122
Binary files /dev/null and b/avian/assets/illustrations/leiothlypis-celata.png differ
diff --git a/avian/assets/illustrations/leiothlypis-lucidae.png b/avian/assets/illustrations/leiothlypis-lucidae.png
new file mode 100644
index 0000000..25d4706
Binary files /dev/null and b/avian/assets/illustrations/leiothlypis-lucidae.png differ
diff --git a/avian/assets/illustrations/leucophaeus-atricilla-2.png b/avian/assets/illustrations/leucophaeus-atricilla-2.png
new file mode 100644
index 0000000..057c73a
Binary files /dev/null and b/avian/assets/illustrations/leucophaeus-atricilla-2.png differ
diff --git a/avian/assets/illustrations/leucophaeus-atricilla.png b/avian/assets/illustrations/leucophaeus-atricilla.png
new file mode 100644
index 0000000..ba1840c
Binary files /dev/null and b/avian/assets/illustrations/leucophaeus-atricilla.png differ
diff --git a/avian/assets/illustrations/leucophaeus-pipixcan-2.png b/avian/assets/illustrations/leucophaeus-pipixcan-2.png
new file mode 100644
index 0000000..d55201e
Binary files /dev/null and b/avian/assets/illustrations/leucophaeus-pipixcan-2.png differ
diff --git a/avian/assets/illustrations/leucophaeus-pipixcan.png b/avian/assets/illustrations/leucophaeus-pipixcan.png
new file mode 100644
index 0000000..232c392
Binary files /dev/null and b/avian/assets/illustrations/leucophaeus-pipixcan.png differ
diff --git a/avian/assets/illustrations/leucosticte-tephrocotis-2.png b/avian/assets/illustrations/leucosticte-tephrocotis-2.png
new file mode 100644
index 0000000..4c50024
Binary files /dev/null and b/avian/assets/illustrations/leucosticte-tephrocotis-2.png differ
diff --git a/avian/assets/illustrations/leucosticte-tephrocotis.png b/avian/assets/illustrations/leucosticte-tephrocotis.png
new file mode 100644
index 0000000..b87ba15
Binary files /dev/null and b/avian/assets/illustrations/leucosticte-tephrocotis.png differ
diff --git a/avian/assets/illustrations/limosa-fedoa-2.png b/avian/assets/illustrations/limosa-fedoa-2.png
new file mode 100644
index 0000000..eecf7da
Binary files /dev/null and b/avian/assets/illustrations/limosa-fedoa-2.png differ
diff --git a/avian/assets/illustrations/limosa-fedoa.png b/avian/assets/illustrations/limosa-fedoa.png
new file mode 100644
index 0000000..e5f5304
Binary files /dev/null and b/avian/assets/illustrations/limosa-fedoa.png differ
diff --git a/avian/assets/illustrations/lophodytes-cucullatus-2.png b/avian/assets/illustrations/lophodytes-cucullatus-2.png
new file mode 100644
index 0000000..8bed43c
Binary files /dev/null and b/avian/assets/illustrations/lophodytes-cucullatus-2.png differ
diff --git a/avian/assets/illustrations/lophodytes-cucullatus.png b/avian/assets/illustrations/lophodytes-cucullatus.png
new file mode 100644
index 0000000..51c42fb
Binary files /dev/null and b/avian/assets/illustrations/lophodytes-cucullatus.png differ
diff --git a/avian/assets/illustrations/loxia-curvirostra-2.png b/avian/assets/illustrations/loxia-curvirostra-2.png
new file mode 100644
index 0000000..df0ec5d
Binary files /dev/null and b/avian/assets/illustrations/loxia-curvirostra-2.png differ
diff --git a/avian/assets/illustrations/loxia-curvirostra.png b/avian/assets/illustrations/loxia-curvirostra.png
new file mode 100644
index 0000000..b57e4a1
Binary files /dev/null and b/avian/assets/illustrations/loxia-curvirostra.png differ
diff --git a/avian/assets/illustrations/mareca-americana-2.png b/avian/assets/illustrations/mareca-americana-2.png
new file mode 100644
index 0000000..951a98b
Binary files /dev/null and b/avian/assets/illustrations/mareca-americana-2.png differ
diff --git a/avian/assets/illustrations/mareca-americana.png b/avian/assets/illustrations/mareca-americana.png
new file mode 100644
index 0000000..0c80dbf
Binary files /dev/null and b/avian/assets/illustrations/mareca-americana.png differ
diff --git a/avian/assets/illustrations/mareca-strepera-2.png b/avian/assets/illustrations/mareca-strepera-2.png
new file mode 100644
index 0000000..4755fd2
Binary files /dev/null and b/avian/assets/illustrations/mareca-strepera-2.png differ
diff --git a/avian/assets/illustrations/mareca-strepera.png b/avian/assets/illustrations/mareca-strepera.png
new file mode 100644
index 0000000..2648a85
Binary files /dev/null and b/avian/assets/illustrations/mareca-strepera.png differ
diff --git a/avian/assets/illustrations/megaceryle-alcyon-2.png b/avian/assets/illustrations/megaceryle-alcyon-2.png
new file mode 100644
index 0000000..633bba6
Binary files /dev/null and b/avian/assets/illustrations/megaceryle-alcyon-2.png differ
diff --git a/avian/assets/illustrations/megaceryle-alcyon.png b/avian/assets/illustrations/megaceryle-alcyon.png
new file mode 100644
index 0000000..8a09f82
Binary files /dev/null and b/avian/assets/illustrations/megaceryle-alcyon.png differ
diff --git a/avian/assets/illustrations/megascops-kennicottii.png b/avian/assets/illustrations/megascops-kennicottii.png
new file mode 100644
index 0000000..3db3b4f
Binary files /dev/null and b/avian/assets/illustrations/megascops-kennicottii.png differ
diff --git a/avian/assets/illustrations/melanerpes-formicivorus-2.png b/avian/assets/illustrations/melanerpes-formicivorus-2.png
new file mode 100644
index 0000000..a41b26e
Binary files /dev/null and b/avian/assets/illustrations/melanerpes-formicivorus-2.png differ
diff --git a/avian/assets/illustrations/melanerpes-formicivorus.png b/avian/assets/illustrations/melanerpes-formicivorus.png
new file mode 100644
index 0000000..5f44d0e
Binary files /dev/null and b/avian/assets/illustrations/melanerpes-formicivorus.png differ
diff --git a/avian/assets/illustrations/melanerpes-lewis-2.png b/avian/assets/illustrations/melanerpes-lewis-2.png
new file mode 100644
index 0000000..eba4665
Binary files /dev/null and b/avian/assets/illustrations/melanerpes-lewis-2.png differ
diff --git a/avian/assets/illustrations/melanerpes-lewis.png b/avian/assets/illustrations/melanerpes-lewis.png
new file mode 100644
index 0000000..39a9ce5
Binary files /dev/null and b/avian/assets/illustrations/melanerpes-lewis.png differ
diff --git a/avian/assets/illustrations/meleagris-gallopavo-2.png b/avian/assets/illustrations/meleagris-gallopavo-2.png
new file mode 100644
index 0000000..a47b519
Binary files /dev/null and b/avian/assets/illustrations/meleagris-gallopavo-2.png differ
diff --git a/avian/assets/illustrations/meleagris-gallopavo.png b/avian/assets/illustrations/meleagris-gallopavo.png
new file mode 100644
index 0000000..8b899b1
Binary files /dev/null and b/avian/assets/illustrations/meleagris-gallopavo.png differ
diff --git a/avian/assets/illustrations/melospiza-georgiana-2.png b/avian/assets/illustrations/melospiza-georgiana-2.png
new file mode 100644
index 0000000..303870e
Binary files /dev/null and b/avian/assets/illustrations/melospiza-georgiana-2.png differ
diff --git a/avian/assets/illustrations/melospiza-georgiana.png b/avian/assets/illustrations/melospiza-georgiana.png
new file mode 100644
index 0000000..71d3d3f
Binary files /dev/null and b/avian/assets/illustrations/melospiza-georgiana.png differ
diff --git a/avian/assets/illustrations/melospiza-lincolnii.png b/avian/assets/illustrations/melospiza-lincolnii.png
new file mode 100644
index 0000000..05f50e6
Binary files /dev/null and b/avian/assets/illustrations/melospiza-lincolnii.png differ
diff --git a/avian/assets/illustrations/melospiza-melodia-2.png b/avian/assets/illustrations/melospiza-melodia-2.png
new file mode 100644
index 0000000..1bd928a
Binary files /dev/null and b/avian/assets/illustrations/melospiza-melodia-2.png differ
diff --git a/avian/assets/illustrations/melospiza-melodia.png b/avian/assets/illustrations/melospiza-melodia.png
new file mode 100644
index 0000000..d075a6c
Binary files /dev/null and b/avian/assets/illustrations/melospiza-melodia.png differ
diff --git a/avian/assets/illustrations/melozone-aberti.png b/avian/assets/illustrations/melozone-aberti.png
new file mode 100644
index 0000000..da69f0f
Binary files /dev/null and b/avian/assets/illustrations/melozone-aberti.png differ
diff --git a/avian/assets/illustrations/melozone-crissalis-2.png b/avian/assets/illustrations/melozone-crissalis-2.png
new file mode 100644
index 0000000..434c598
Binary files /dev/null and b/avian/assets/illustrations/melozone-crissalis-2.png differ
diff --git a/avian/assets/illustrations/melozone-crissalis.png b/avian/assets/illustrations/melozone-crissalis.png
new file mode 100644
index 0000000..93a0b82
Binary files /dev/null and b/avian/assets/illustrations/melozone-crissalis.png differ
diff --git a/avian/assets/illustrations/melozone-fusca.png b/avian/assets/illustrations/melozone-fusca.png
new file mode 100644
index 0000000..d7695bc
Binary files /dev/null and b/avian/assets/illustrations/melozone-fusca.png differ
diff --git a/avian/assets/illustrations/mergus-merganser-2.png b/avian/assets/illustrations/mergus-merganser-2.png
new file mode 100644
index 0000000..8a7b45f
Binary files /dev/null and b/avian/assets/illustrations/mergus-merganser-2.png differ
diff --git a/avian/assets/illustrations/mergus-merganser.png b/avian/assets/illustrations/mergus-merganser.png
new file mode 100644
index 0000000..4a84d6a
Binary files /dev/null and b/avian/assets/illustrations/mergus-merganser.png differ
diff --git a/avian/assets/illustrations/mimus-polyglottos-2.png b/avian/assets/illustrations/mimus-polyglottos-2.png
new file mode 100644
index 0000000..9008f95
Binary files /dev/null and b/avian/assets/illustrations/mimus-polyglottos-2.png differ
diff --git a/avian/assets/illustrations/mimus-polyglottos.png b/avian/assets/illustrations/mimus-polyglottos.png
new file mode 100644
index 0000000..67749c1
Binary files /dev/null and b/avian/assets/illustrations/mimus-polyglottos.png differ
diff --git a/avian/assets/illustrations/mniotilta-varia-2.png b/avian/assets/illustrations/mniotilta-varia-2.png
new file mode 100644
index 0000000..d5c134a
Binary files /dev/null and b/avian/assets/illustrations/mniotilta-varia-2.png differ
diff --git a/avian/assets/illustrations/mniotilta-varia.png b/avian/assets/illustrations/mniotilta-varia.png
new file mode 100644
index 0000000..86a85a9
Binary files /dev/null and b/avian/assets/illustrations/mniotilta-varia.png differ
diff --git a/avian/assets/illustrations/molothrus-ater-2.png b/avian/assets/illustrations/molothrus-ater-2.png
new file mode 100644
index 0000000..8d37c11
Binary files /dev/null and b/avian/assets/illustrations/molothrus-ater-2.png differ
diff --git a/avian/assets/illustrations/molothrus-ater.png b/avian/assets/illustrations/molothrus-ater.png
new file mode 100644
index 0000000..03297de
Binary files /dev/null and b/avian/assets/illustrations/molothrus-ater.png differ
diff --git a/avian/assets/illustrations/myadestes-townsendi-2.png b/avian/assets/illustrations/myadestes-townsendi-2.png
new file mode 100644
index 0000000..334e23a
Binary files /dev/null and b/avian/assets/illustrations/myadestes-townsendi-2.png differ
diff --git a/avian/assets/illustrations/myadestes-townsendi.png b/avian/assets/illustrations/myadestes-townsendi.png
new file mode 100644
index 0000000..861f9cd
Binary files /dev/null and b/avian/assets/illustrations/myadestes-townsendi.png differ
diff --git a/avian/assets/illustrations/myiarchus-cinerascens-2.png b/avian/assets/illustrations/myiarchus-cinerascens-2.png
new file mode 100644
index 0000000..b1f12d8
Binary files /dev/null and b/avian/assets/illustrations/myiarchus-cinerascens-2.png differ
diff --git a/avian/assets/illustrations/myiarchus-cinerascens.png b/avian/assets/illustrations/myiarchus-cinerascens.png
new file mode 100644
index 0000000..9a4f3c0
Binary files /dev/null and b/avian/assets/illustrations/myiarchus-cinerascens.png differ
diff --git a/avian/assets/illustrations/nucifraga-columbiana-2.png b/avian/assets/illustrations/nucifraga-columbiana-2.png
new file mode 100644
index 0000000..14558d8
Binary files /dev/null and b/avian/assets/illustrations/nucifraga-columbiana-2.png differ
diff --git a/avian/assets/illustrations/nucifraga-columbiana.png b/avian/assets/illustrations/nucifraga-columbiana.png
new file mode 100644
index 0000000..2733dc6
Binary files /dev/null and b/avian/assets/illustrations/nucifraga-columbiana.png differ
diff --git a/avian/assets/illustrations/numenius-americanus-2.png b/avian/assets/illustrations/numenius-americanus-2.png
new file mode 100644
index 0000000..0dfa663
Binary files /dev/null and b/avian/assets/illustrations/numenius-americanus-2.png differ
diff --git a/avian/assets/illustrations/numenius-americanus.png b/avian/assets/illustrations/numenius-americanus.png
new file mode 100644
index 0000000..b53c503
Binary files /dev/null and b/avian/assets/illustrations/numenius-americanus.png differ
diff --git a/avian/assets/illustrations/nycticorax-nycticorax-2.png b/avian/assets/illustrations/nycticorax-nycticorax-2.png
new file mode 100644
index 0000000..9f193ef
Binary files /dev/null and b/avian/assets/illustrations/nycticorax-nycticorax-2.png differ
diff --git a/avian/assets/illustrations/nycticorax-nycticorax.png b/avian/assets/illustrations/nycticorax-nycticorax.png
new file mode 100644
index 0000000..c09f11d
Binary files /dev/null and b/avian/assets/illustrations/nycticorax-nycticorax.png differ
diff --git a/avian/assets/illustrations/oreothlypis-ruficapilla.png b/avian/assets/illustrations/oreothlypis-ruficapilla.png
new file mode 100644
index 0000000..ca79e1d
Binary files /dev/null and b/avian/assets/illustrations/oreothlypis-ruficapilla.png differ
diff --git a/avian/assets/illustrations/pandion-haliaetus-2.png b/avian/assets/illustrations/pandion-haliaetus-2.png
new file mode 100644
index 0000000..b6ca341
Binary files /dev/null and b/avian/assets/illustrations/pandion-haliaetus-2.png differ
diff --git a/avian/assets/illustrations/pandion-haliaetus.png b/avian/assets/illustrations/pandion-haliaetus.png
new file mode 100644
index 0000000..9ff6f00
Binary files /dev/null and b/avian/assets/illustrations/pandion-haliaetus.png differ
diff --git a/avian/assets/illustrations/passer-domesticus-2.png b/avian/assets/illustrations/passer-domesticus-2.png
new file mode 100644
index 0000000..b2bca82
Binary files /dev/null and b/avian/assets/illustrations/passer-domesticus-2.png differ
diff --git a/avian/assets/illustrations/passer-domesticus.png b/avian/assets/illustrations/passer-domesticus.png
new file mode 100644
index 0000000..2f30b46
Binary files /dev/null and b/avian/assets/illustrations/passer-domesticus.png differ
diff --git a/avian/assets/illustrations/passerculus-sandwichensis-2.png b/avian/assets/illustrations/passerculus-sandwichensis-2.png
new file mode 100644
index 0000000..e6084a6
Binary files /dev/null and b/avian/assets/illustrations/passerculus-sandwichensis-2.png differ
diff --git a/avian/assets/illustrations/passerculus-sandwichensis.png b/avian/assets/illustrations/passerculus-sandwichensis.png
new file mode 100644
index 0000000..2b021e9
Binary files /dev/null and b/avian/assets/illustrations/passerculus-sandwichensis.png differ
diff --git a/avian/assets/illustrations/passerella-iliaca.png b/avian/assets/illustrations/passerella-iliaca.png
new file mode 100644
index 0000000..db75991
Binary files /dev/null and b/avian/assets/illustrations/passerella-iliaca.png differ
diff --git a/avian/assets/illustrations/passerina-amoena.png b/avian/assets/illustrations/passerina-amoena.png
new file mode 100644
index 0000000..dd4aa47
Binary files /dev/null and b/avian/assets/illustrations/passerina-amoena.png differ
diff --git a/avian/assets/illustrations/passerina-cyanea-2.png b/avian/assets/illustrations/passerina-cyanea-2.png
new file mode 100644
index 0000000..bf7e42c
Binary files /dev/null and b/avian/assets/illustrations/passerina-cyanea-2.png differ
diff --git a/avian/assets/illustrations/passerina-cyanea.png b/avian/assets/illustrations/passerina-cyanea.png
new file mode 100644
index 0000000..08b650d
Binary files /dev/null and b/avian/assets/illustrations/passerina-cyanea.png differ
diff --git a/avian/assets/illustrations/patagioenas-fasciata-2.png b/avian/assets/illustrations/patagioenas-fasciata-2.png
new file mode 100644
index 0000000..fb6d66b
Binary files /dev/null and b/avian/assets/illustrations/patagioenas-fasciata-2.png differ
diff --git a/avian/assets/illustrations/patagioenas-fasciata.png b/avian/assets/illustrations/patagioenas-fasciata.png
new file mode 100644
index 0000000..6196275
Binary files /dev/null and b/avian/assets/illustrations/patagioenas-fasciata.png differ
diff --git a/avian/assets/illustrations/pelecanus-erythrorhynchos-2.png b/avian/assets/illustrations/pelecanus-erythrorhynchos-2.png
new file mode 100644
index 0000000..2663cc9
Binary files /dev/null and b/avian/assets/illustrations/pelecanus-erythrorhynchos-2.png differ
diff --git a/avian/assets/illustrations/pelecanus-erythrorhynchos.png b/avian/assets/illustrations/pelecanus-erythrorhynchos.png
new file mode 100644
index 0000000..10760c7
Binary files /dev/null and b/avian/assets/illustrations/pelecanus-erythrorhynchos.png differ
diff --git a/avian/assets/illustrations/pelecanus-occidentalis-2.png b/avian/assets/illustrations/pelecanus-occidentalis-2.png
new file mode 100644
index 0000000..8223945
Binary files /dev/null and b/avian/assets/illustrations/pelecanus-occidentalis-2.png differ
diff --git a/avian/assets/illustrations/pelecanus-occidentalis.png b/avian/assets/illustrations/pelecanus-occidentalis.png
new file mode 100644
index 0000000..e3f30f0
Binary files /dev/null and b/avian/assets/illustrations/pelecanus-occidentalis.png differ
diff --git a/avian/assets/illustrations/perisoreus-canadensis-2.png b/avian/assets/illustrations/perisoreus-canadensis-2.png
new file mode 100644
index 0000000..eda297c
Binary files /dev/null and b/avian/assets/illustrations/perisoreus-canadensis-2.png differ
diff --git a/avian/assets/illustrations/perisoreus-canadensis.png b/avian/assets/illustrations/perisoreus-canadensis.png
new file mode 100644
index 0000000..716b9d7
Binary files /dev/null and b/avian/assets/illustrations/perisoreus-canadensis.png differ
diff --git a/avian/assets/illustrations/petrochelidon-pyrrhonota-2.png b/avian/assets/illustrations/petrochelidon-pyrrhonota-2.png
new file mode 100644
index 0000000..f73223c
Binary files /dev/null and b/avian/assets/illustrations/petrochelidon-pyrrhonota-2.png differ
diff --git a/avian/assets/illustrations/petrochelidon-pyrrhonota.png b/avian/assets/illustrations/petrochelidon-pyrrhonota.png
new file mode 100644
index 0000000..ca9f0c9
Binary files /dev/null and b/avian/assets/illustrations/petrochelidon-pyrrhonota.png differ
diff --git a/avian/assets/illustrations/phainopepla-nitens-2.png b/avian/assets/illustrations/phainopepla-nitens-2.png
new file mode 100644
index 0000000..d9f94e2
Binary files /dev/null and b/avian/assets/illustrations/phainopepla-nitens-2.png differ
diff --git a/avian/assets/illustrations/phainopepla-nitens.png b/avian/assets/illustrations/phainopepla-nitens.png
new file mode 100644
index 0000000..624301d
Binary files /dev/null and b/avian/assets/illustrations/phainopepla-nitens.png differ
diff --git a/avian/assets/illustrations/phalacrocorax-auritus-2.png b/avian/assets/illustrations/phalacrocorax-auritus-2.png
new file mode 100644
index 0000000..182ddc9
Binary files /dev/null and b/avian/assets/illustrations/phalacrocorax-auritus-2.png differ
diff --git a/avian/assets/illustrations/phalacrocorax-auritus.png b/avian/assets/illustrations/phalacrocorax-auritus.png
new file mode 100644
index 0000000..56b5583
Binary files /dev/null and b/avian/assets/illustrations/phalacrocorax-auritus.png differ
diff --git a/avian/assets/illustrations/phalaenoptilus-nuttallii.png b/avian/assets/illustrations/phalaenoptilus-nuttallii.png
new file mode 100644
index 0000000..d9f55f2
Binary files /dev/null and b/avian/assets/illustrations/phalaenoptilus-nuttallii.png differ
diff --git a/avian/assets/illustrations/phasianus-colchicus-2.png b/avian/assets/illustrations/phasianus-colchicus-2.png
new file mode 100644
index 0000000..b837018
Binary files /dev/null and b/avian/assets/illustrations/phasianus-colchicus-2.png differ
diff --git a/avian/assets/illustrations/phasianus-colchicus.png b/avian/assets/illustrations/phasianus-colchicus.png
new file mode 100644
index 0000000..7a59924
Binary files /dev/null and b/avian/assets/illustrations/phasianus-colchicus.png differ
diff --git a/avian/assets/illustrations/pheucticus-melanocephalus-2.png b/avian/assets/illustrations/pheucticus-melanocephalus-2.png
new file mode 100644
index 0000000..9d42a1c
Binary files /dev/null and b/avian/assets/illustrations/pheucticus-melanocephalus-2.png differ
diff --git a/avian/assets/illustrations/pheucticus-melanocephalus.png b/avian/assets/illustrations/pheucticus-melanocephalus.png
new file mode 100644
index 0000000..a1e7570
Binary files /dev/null and b/avian/assets/illustrations/pheucticus-melanocephalus.png differ
diff --git a/avian/assets/illustrations/pica-nuttalli-2.png b/avian/assets/illustrations/pica-nuttalli-2.png
new file mode 100644
index 0000000..4f8daab
Binary files /dev/null and b/avian/assets/illustrations/pica-nuttalli-2.png differ
diff --git a/avian/assets/illustrations/pica-nuttalli.png b/avian/assets/illustrations/pica-nuttalli.png
new file mode 100644
index 0000000..3061380
Binary files /dev/null and b/avian/assets/illustrations/pica-nuttalli.png differ
diff --git a/avian/assets/illustrations/picoides-arcticus.png b/avian/assets/illustrations/picoides-arcticus.png
new file mode 100644
index 0000000..f5961f0
Binary files /dev/null and b/avian/assets/illustrations/picoides-arcticus.png differ
diff --git a/avian/assets/illustrations/pinicola-enucleator.png b/avian/assets/illustrations/pinicola-enucleator.png
new file mode 100644
index 0000000..c481789
Binary files /dev/null and b/avian/assets/illustrations/pinicola-enucleator.png differ
diff --git a/avian/assets/illustrations/pipilo-chlorurus.png b/avian/assets/illustrations/pipilo-chlorurus.png
new file mode 100644
index 0000000..7cafc3e
Binary files /dev/null and b/avian/assets/illustrations/pipilo-chlorurus.png differ
diff --git a/avian/assets/illustrations/pipilo-erythrophthalmus.png b/avian/assets/illustrations/pipilo-erythrophthalmus.png
new file mode 100644
index 0000000..c937480
Binary files /dev/null and b/avian/assets/illustrations/pipilo-erythrophthalmus.png differ
diff --git a/avian/assets/illustrations/pipilo-maculatus-2.png b/avian/assets/illustrations/pipilo-maculatus-2.png
new file mode 100644
index 0000000..4e6641a
Binary files /dev/null and b/avian/assets/illustrations/pipilo-maculatus-2.png differ
diff --git a/avian/assets/illustrations/pipilo-maculatus.png b/avian/assets/illustrations/pipilo-maculatus.png
new file mode 100644
index 0000000..d683a22
Binary files /dev/null and b/avian/assets/illustrations/pipilo-maculatus.png differ
diff --git a/avian/assets/illustrations/piranga-ludoviciana-2.png b/avian/assets/illustrations/piranga-ludoviciana-2.png
new file mode 100644
index 0000000..f827df8
Binary files /dev/null and b/avian/assets/illustrations/piranga-ludoviciana-2.png differ
diff --git a/avian/assets/illustrations/piranga-ludoviciana.png b/avian/assets/illustrations/piranga-ludoviciana.png
new file mode 100644
index 0000000..e156944
Binary files /dev/null and b/avian/assets/illustrations/piranga-ludoviciana.png differ
diff --git a/avian/assets/illustrations/piranga-rubra-2.png b/avian/assets/illustrations/piranga-rubra-2.png
new file mode 100644
index 0000000..50ed059
Binary files /dev/null and b/avian/assets/illustrations/piranga-rubra-2.png differ
diff --git a/avian/assets/illustrations/piranga-rubra.png b/avian/assets/illustrations/piranga-rubra.png
new file mode 100644
index 0000000..ba6ec65
Binary files /dev/null and b/avian/assets/illustrations/piranga-rubra.png differ
diff --git a/avian/assets/illustrations/plegadis-chihi-2.png b/avian/assets/illustrations/plegadis-chihi-2.png
new file mode 100644
index 0000000..76e0b22
Binary files /dev/null and b/avian/assets/illustrations/plegadis-chihi-2.png differ
diff --git a/avian/assets/illustrations/plegadis-chihi.png b/avian/assets/illustrations/plegadis-chihi.png
new file mode 100644
index 0000000..808ef11
Binary files /dev/null and b/avian/assets/illustrations/plegadis-chihi.png differ
diff --git a/avian/assets/illustrations/podiceps-nigricollis-2.png b/avian/assets/illustrations/podiceps-nigricollis-2.png
new file mode 100644
index 0000000..ed4a87a
Binary files /dev/null and b/avian/assets/illustrations/podiceps-nigricollis-2.png differ
diff --git a/avian/assets/illustrations/podiceps-nigricollis.png b/avian/assets/illustrations/podiceps-nigricollis.png
new file mode 100644
index 0000000..6408a00
Binary files /dev/null and b/avian/assets/illustrations/podiceps-nigricollis.png differ
diff --git a/avian/assets/illustrations/podilymbus-podiceps.png b/avian/assets/illustrations/podilymbus-podiceps.png
new file mode 100644
index 0000000..5f089a7
Binary files /dev/null and b/avian/assets/illustrations/podilymbus-podiceps.png differ
diff --git a/avian/assets/illustrations/poecile-gambeli-2.png b/avian/assets/illustrations/poecile-gambeli-2.png
new file mode 100644
index 0000000..9cdc856
Binary files /dev/null and b/avian/assets/illustrations/poecile-gambeli-2.png differ
diff --git a/avian/assets/illustrations/poecile-gambeli.png b/avian/assets/illustrations/poecile-gambeli.png
new file mode 100644
index 0000000..f4059e0
Binary files /dev/null and b/avian/assets/illustrations/poecile-gambeli.png differ
diff --git a/avian/assets/illustrations/poecile-rufescens-2.png b/avian/assets/illustrations/poecile-rufescens-2.png
new file mode 100644
index 0000000..9e9bc33
Binary files /dev/null and b/avian/assets/illustrations/poecile-rufescens-2.png differ
diff --git a/avian/assets/illustrations/poecile-rufescens.png b/avian/assets/illustrations/poecile-rufescens.png
new file mode 100644
index 0000000..4e88803
Binary files /dev/null and b/avian/assets/illustrations/poecile-rufescens.png differ
diff --git a/avian/assets/illustrations/polioptila-caerulea-2.png b/avian/assets/illustrations/polioptila-caerulea-2.png
new file mode 100644
index 0000000..7f92d40
Binary files /dev/null and b/avian/assets/illustrations/polioptila-caerulea-2.png differ
diff --git a/avian/assets/illustrations/polioptila-caerulea.png b/avian/assets/illustrations/polioptila-caerulea.png
new file mode 100644
index 0000000..a5613ba
Binary files /dev/null and b/avian/assets/illustrations/polioptila-caerulea.png differ
diff --git a/avian/assets/illustrations/pooecetes-gramineus.png b/avian/assets/illustrations/pooecetes-gramineus.png
new file mode 100644
index 0000000..2559f8b
Binary files /dev/null and b/avian/assets/illustrations/pooecetes-gramineus.png differ
diff --git a/avian/assets/illustrations/progne-subis-2.png b/avian/assets/illustrations/progne-subis-2.png
new file mode 100644
index 0000000..a9fa648
Binary files /dev/null and b/avian/assets/illustrations/progne-subis-2.png differ
diff --git a/avian/assets/illustrations/progne-subis.png b/avian/assets/illustrations/progne-subis.png
new file mode 100644
index 0000000..b4cd36b
Binary files /dev/null and b/avian/assets/illustrations/progne-subis.png differ
diff --git a/avian/assets/illustrations/psaltriparus-minimus-2.png b/avian/assets/illustrations/psaltriparus-minimus-2.png
new file mode 100644
index 0000000..f554a6c
Binary files /dev/null and b/avian/assets/illustrations/psaltriparus-minimus-2.png differ
diff --git a/avian/assets/illustrations/psaltriparus-minimus.png b/avian/assets/illustrations/psaltriparus-minimus.png
new file mode 100644
index 0000000..f8d434b
Binary files /dev/null and b/avian/assets/illustrations/psaltriparus-minimus.png differ
diff --git a/avian/assets/illustrations/quiscalus-mexicanus-2.png b/avian/assets/illustrations/quiscalus-mexicanus-2.png
new file mode 100644
index 0000000..9d5d5a9
Binary files /dev/null and b/avian/assets/illustrations/quiscalus-mexicanus-2.png differ
diff --git a/avian/assets/illustrations/quiscalus-mexicanus.png b/avian/assets/illustrations/quiscalus-mexicanus.png
new file mode 100644
index 0000000..0145479
Binary files /dev/null and b/avian/assets/illustrations/quiscalus-mexicanus.png differ
diff --git a/avian/assets/illustrations/recurvirostra-americana-2.png b/avian/assets/illustrations/recurvirostra-americana-2.png
new file mode 100644
index 0000000..1756498
Binary files /dev/null and b/avian/assets/illustrations/recurvirostra-americana-2.png differ
diff --git a/avian/assets/illustrations/recurvirostra-americana.png b/avian/assets/illustrations/recurvirostra-americana.png
new file mode 100644
index 0000000..47c334c
Binary files /dev/null and b/avian/assets/illustrations/recurvirostra-americana.png differ
diff --git a/avian/assets/illustrations/regulus-calendula-2.png b/avian/assets/illustrations/regulus-calendula-2.png
new file mode 100644
index 0000000..d24a1c2
Binary files /dev/null and b/avian/assets/illustrations/regulus-calendula-2.png differ
diff --git a/avian/assets/illustrations/regulus-calendula.png b/avian/assets/illustrations/regulus-calendula.png
new file mode 100644
index 0000000..36bf85e
Binary files /dev/null and b/avian/assets/illustrations/regulus-calendula.png differ
diff --git a/avian/assets/illustrations/regulus-satrapa.png b/avian/assets/illustrations/regulus-satrapa.png
new file mode 100644
index 0000000..52ab75d
Binary files /dev/null and b/avian/assets/illustrations/regulus-satrapa.png differ
diff --git a/avian/assets/illustrations/riparia-riparia-2.png b/avian/assets/illustrations/riparia-riparia-2.png
new file mode 100644
index 0000000..d66f222
Binary files /dev/null and b/avian/assets/illustrations/riparia-riparia-2.png differ
diff --git a/avian/assets/illustrations/riparia-riparia.png b/avian/assets/illustrations/riparia-riparia.png
new file mode 100644
index 0000000..25082bd
Binary files /dev/null and b/avian/assets/illustrations/riparia-riparia.png differ
diff --git a/avian/assets/illustrations/rynchops-niger-2.png b/avian/assets/illustrations/rynchops-niger-2.png
new file mode 100644
index 0000000..46c2c53
Binary files /dev/null and b/avian/assets/illustrations/rynchops-niger-2.png differ
diff --git a/avian/assets/illustrations/rynchops-niger.png b/avian/assets/illustrations/rynchops-niger.png
new file mode 100644
index 0000000..412f08c
Binary files /dev/null and b/avian/assets/illustrations/rynchops-niger.png differ
diff --git a/avian/assets/illustrations/salpinctes-obsoletus.png b/avian/assets/illustrations/salpinctes-obsoletus.png
new file mode 100644
index 0000000..cc3a675
Binary files /dev/null and b/avian/assets/illustrations/salpinctes-obsoletus.png differ
diff --git a/avian/assets/illustrations/sayornis-nigricans-2.png b/avian/assets/illustrations/sayornis-nigricans-2.png
new file mode 100644
index 0000000..87aa1c3
Binary files /dev/null and b/avian/assets/illustrations/sayornis-nigricans-2.png differ
diff --git a/avian/assets/illustrations/sayornis-nigricans.png b/avian/assets/illustrations/sayornis-nigricans.png
new file mode 100644
index 0000000..d22e964
Binary files /dev/null and b/avian/assets/illustrations/sayornis-nigricans.png differ
diff --git a/avian/assets/illustrations/sayornis-saya-2.png b/avian/assets/illustrations/sayornis-saya-2.png
new file mode 100644
index 0000000..1f3ad24
Binary files /dev/null and b/avian/assets/illustrations/sayornis-saya-2.png differ
diff --git a/avian/assets/illustrations/sayornis-saya.png b/avian/assets/illustrations/sayornis-saya.png
new file mode 100644
index 0000000..6742b51
Binary files /dev/null and b/avian/assets/illustrations/sayornis-saya.png differ
diff --git a/avian/assets/illustrations/selasphorus-platycercus-2.png b/avian/assets/illustrations/selasphorus-platycercus-2.png
new file mode 100644
index 0000000..e633c16
Binary files /dev/null and b/avian/assets/illustrations/selasphorus-platycercus-2.png differ
diff --git a/avian/assets/illustrations/selasphorus-platycercus.png b/avian/assets/illustrations/selasphorus-platycercus.png
new file mode 100644
index 0000000..d24936e
Binary files /dev/null and b/avian/assets/illustrations/selasphorus-platycercus.png differ
diff --git a/avian/assets/illustrations/selasphorus-rufus-2.png b/avian/assets/illustrations/selasphorus-rufus-2.png
new file mode 100644
index 0000000..69c19ed
Binary files /dev/null and b/avian/assets/illustrations/selasphorus-rufus-2.png differ
diff --git a/avian/assets/illustrations/selasphorus-rufus.png b/avian/assets/illustrations/selasphorus-rufus.png
new file mode 100644
index 0000000..a596ba8
Binary files /dev/null and b/avian/assets/illustrations/selasphorus-rufus.png differ
diff --git a/avian/assets/illustrations/selasphorus-sasin-2.png b/avian/assets/illustrations/selasphorus-sasin-2.png
new file mode 100644
index 0000000..f372a1a
Binary files /dev/null and b/avian/assets/illustrations/selasphorus-sasin-2.png differ
diff --git a/avian/assets/illustrations/selasphorus-sasin.png b/avian/assets/illustrations/selasphorus-sasin.png
new file mode 100644
index 0000000..2ae90fc
Binary files /dev/null and b/avian/assets/illustrations/selasphorus-sasin.png differ
diff --git a/avian/assets/illustrations/setophaga-coronata-2.png b/avian/assets/illustrations/setophaga-coronata-2.png
new file mode 100644
index 0000000..b96e959
Binary files /dev/null and b/avian/assets/illustrations/setophaga-coronata-2.png differ
diff --git a/avian/assets/illustrations/setophaga-coronata.png b/avian/assets/illustrations/setophaga-coronata.png
new file mode 100644
index 0000000..7bb8de9
Binary files /dev/null and b/avian/assets/illustrations/setophaga-coronata.png differ
diff --git a/avian/assets/illustrations/setophaga-magnolia.png b/avian/assets/illustrations/setophaga-magnolia.png
new file mode 100644
index 0000000..f27a49f
Binary files /dev/null and b/avian/assets/illustrations/setophaga-magnolia.png differ
diff --git a/avian/assets/illustrations/setophaga-nigrescens-2.png b/avian/assets/illustrations/setophaga-nigrescens-2.png
new file mode 100644
index 0000000..89878c8
Binary files /dev/null and b/avian/assets/illustrations/setophaga-nigrescens-2.png differ
diff --git a/avian/assets/illustrations/setophaga-nigrescens.png b/avian/assets/illustrations/setophaga-nigrescens.png
new file mode 100644
index 0000000..469c756
Binary files /dev/null and b/avian/assets/illustrations/setophaga-nigrescens.png differ
diff --git a/avian/assets/illustrations/setophaga-occidentalis-2.png b/avian/assets/illustrations/setophaga-occidentalis-2.png
new file mode 100644
index 0000000..d68340f
Binary files /dev/null and b/avian/assets/illustrations/setophaga-occidentalis-2.png differ
diff --git a/avian/assets/illustrations/setophaga-occidentalis.png b/avian/assets/illustrations/setophaga-occidentalis.png
new file mode 100644
index 0000000..709c8cb
Binary files /dev/null and b/avian/assets/illustrations/setophaga-occidentalis.png differ
diff --git a/avian/assets/illustrations/setophaga-palmarum-2.png b/avian/assets/illustrations/setophaga-palmarum-2.png
new file mode 100644
index 0000000..7266951
Binary files /dev/null and b/avian/assets/illustrations/setophaga-palmarum-2.png differ
diff --git a/avian/assets/illustrations/setophaga-palmarum.png b/avian/assets/illustrations/setophaga-palmarum.png
new file mode 100644
index 0000000..75c65e2
Binary files /dev/null and b/avian/assets/illustrations/setophaga-palmarum.png differ
diff --git a/avian/assets/illustrations/setophaga-petechia.png b/avian/assets/illustrations/setophaga-petechia.png
new file mode 100644
index 0000000..20ae10b
Binary files /dev/null and b/avian/assets/illustrations/setophaga-petechia.png differ
diff --git a/avian/assets/illustrations/setophaga-ruticilla.png b/avian/assets/illustrations/setophaga-ruticilla.png
new file mode 100644
index 0000000..05aab34
Binary files /dev/null and b/avian/assets/illustrations/setophaga-ruticilla.png differ
diff --git a/avian/assets/illustrations/setophaga-townsendi-2.png b/avian/assets/illustrations/setophaga-townsendi-2.png
new file mode 100644
index 0000000..5cb0379
Binary files /dev/null and b/avian/assets/illustrations/setophaga-townsendi-2.png differ
diff --git a/avian/assets/illustrations/setophaga-townsendi.png b/avian/assets/illustrations/setophaga-townsendi.png
new file mode 100644
index 0000000..49ea06d
Binary files /dev/null and b/avian/assets/illustrations/setophaga-townsendi.png differ
diff --git a/avian/assets/illustrations/sialia-currucoides-2.png b/avian/assets/illustrations/sialia-currucoides-2.png
new file mode 100644
index 0000000..86c9254
Binary files /dev/null and b/avian/assets/illustrations/sialia-currucoides-2.png differ
diff --git a/avian/assets/illustrations/sialia-currucoides.png b/avian/assets/illustrations/sialia-currucoides.png
new file mode 100644
index 0000000..0a84e49
Binary files /dev/null and b/avian/assets/illustrations/sialia-currucoides.png differ
diff --git a/avian/assets/illustrations/sialia-mexicana-2.png b/avian/assets/illustrations/sialia-mexicana-2.png
new file mode 100644
index 0000000..9843c7c
Binary files /dev/null and b/avian/assets/illustrations/sialia-mexicana-2.png differ
diff --git a/avian/assets/illustrations/sialia-mexicana.png b/avian/assets/illustrations/sialia-mexicana.png
new file mode 100644
index 0000000..36343b6
Binary files /dev/null and b/avian/assets/illustrations/sialia-mexicana.png differ
diff --git a/avian/assets/illustrations/sitta-canadensis-2.png b/avian/assets/illustrations/sitta-canadensis-2.png
new file mode 100644
index 0000000..d0ffbf9
Binary files /dev/null and b/avian/assets/illustrations/sitta-canadensis-2.png differ
diff --git a/avian/assets/illustrations/sitta-canadensis.png b/avian/assets/illustrations/sitta-canadensis.png
new file mode 100644
index 0000000..0cc48c1
Binary files /dev/null and b/avian/assets/illustrations/sitta-canadensis.png differ
diff --git a/avian/assets/illustrations/sitta-carolinensis-2.png b/avian/assets/illustrations/sitta-carolinensis-2.png
new file mode 100644
index 0000000..7ad1892
Binary files /dev/null and b/avian/assets/illustrations/sitta-carolinensis-2.png differ
diff --git a/avian/assets/illustrations/sitta-carolinensis.png b/avian/assets/illustrations/sitta-carolinensis.png
new file mode 100644
index 0000000..520f986
Binary files /dev/null and b/avian/assets/illustrations/sitta-carolinensis.png differ
diff --git a/avian/assets/illustrations/sitta-pygmaea.png b/avian/assets/illustrations/sitta-pygmaea.png
new file mode 100644
index 0000000..2ff6b46
Binary files /dev/null and b/avian/assets/illustrations/sitta-pygmaea.png differ
diff --git a/avian/assets/illustrations/spatula-clypeata-2.png b/avian/assets/illustrations/spatula-clypeata-2.png
new file mode 100644
index 0000000..8515d20
Binary files /dev/null and b/avian/assets/illustrations/spatula-clypeata-2.png differ
diff --git a/avian/assets/illustrations/spatula-clypeata.png b/avian/assets/illustrations/spatula-clypeata.png
new file mode 100644
index 0000000..cc2341e
Binary files /dev/null and b/avian/assets/illustrations/spatula-clypeata.png differ
diff --git a/avian/assets/illustrations/spatula-discors-2.png b/avian/assets/illustrations/spatula-discors-2.png
new file mode 100644
index 0000000..e21f1b0
Binary files /dev/null and b/avian/assets/illustrations/spatula-discors-2.png differ
diff --git a/avian/assets/illustrations/spatula-discors.png b/avian/assets/illustrations/spatula-discors.png
new file mode 100644
index 0000000..482f93c
Binary files /dev/null and b/avian/assets/illustrations/spatula-discors.png differ
diff --git a/avian/assets/illustrations/sphyrapicus-ruber-2.png b/avian/assets/illustrations/sphyrapicus-ruber-2.png
new file mode 100644
index 0000000..5b8a390
Binary files /dev/null and b/avian/assets/illustrations/sphyrapicus-ruber-2.png differ
diff --git a/avian/assets/illustrations/sphyrapicus-ruber.png b/avian/assets/illustrations/sphyrapicus-ruber.png
new file mode 100644
index 0000000..584826d
Binary files /dev/null and b/avian/assets/illustrations/sphyrapicus-ruber.png differ
diff --git a/avian/assets/illustrations/sphyrapicus-thyroideus.png b/avian/assets/illustrations/sphyrapicus-thyroideus.png
new file mode 100644
index 0000000..0ffc2f6
Binary files /dev/null and b/avian/assets/illustrations/sphyrapicus-thyroideus.png differ
diff --git a/avian/assets/illustrations/spinus-lawrencei.png b/avian/assets/illustrations/spinus-lawrencei.png
new file mode 100644
index 0000000..fddb58e
Binary files /dev/null and b/avian/assets/illustrations/spinus-lawrencei.png differ
diff --git a/avian/assets/illustrations/spinus-pinus-2.png b/avian/assets/illustrations/spinus-pinus-2.png
new file mode 100644
index 0000000..3a68ce4
Binary files /dev/null and b/avian/assets/illustrations/spinus-pinus-2.png differ
diff --git a/avian/assets/illustrations/spinus-pinus.png b/avian/assets/illustrations/spinus-pinus.png
new file mode 100644
index 0000000..9900519
Binary files /dev/null and b/avian/assets/illustrations/spinus-pinus.png differ
diff --git a/avian/assets/illustrations/spinus-psaltria-2.png b/avian/assets/illustrations/spinus-psaltria-2.png
new file mode 100644
index 0000000..2e7b99c
Binary files /dev/null and b/avian/assets/illustrations/spinus-psaltria-2.png differ
diff --git a/avian/assets/illustrations/spinus-psaltria.png b/avian/assets/illustrations/spinus-psaltria.png
new file mode 100644
index 0000000..a65893a
Binary files /dev/null and b/avian/assets/illustrations/spinus-psaltria.png differ
diff --git a/avian/assets/illustrations/spinus-tristis-2.png b/avian/assets/illustrations/spinus-tristis-2.png
new file mode 100644
index 0000000..5134a3b
Binary files /dev/null and b/avian/assets/illustrations/spinus-tristis-2.png differ
diff --git a/avian/assets/illustrations/spinus-tristis.png b/avian/assets/illustrations/spinus-tristis.png
new file mode 100644
index 0000000..00331b6
Binary files /dev/null and b/avian/assets/illustrations/spinus-tristis.png differ
diff --git a/avian/assets/illustrations/spizella-atrogularis.png b/avian/assets/illustrations/spizella-atrogularis.png
new file mode 100644
index 0000000..05d9a9f
Binary files /dev/null and b/avian/assets/illustrations/spizella-atrogularis.png differ
diff --git a/avian/assets/illustrations/spizella-breweri.png b/avian/assets/illustrations/spizella-breweri.png
new file mode 100644
index 0000000..973c5f4
Binary files /dev/null and b/avian/assets/illustrations/spizella-breweri.png differ
diff --git a/avian/assets/illustrations/spizella-passerina-2.png b/avian/assets/illustrations/spizella-passerina-2.png
new file mode 100644
index 0000000..0de551f
Binary files /dev/null and b/avian/assets/illustrations/spizella-passerina-2.png differ
diff --git a/avian/assets/illustrations/spizella-passerina.png b/avian/assets/illustrations/spizella-passerina.png
new file mode 100644
index 0000000..f2d5089
Binary files /dev/null and b/avian/assets/illustrations/spizella-passerina.png differ
diff --git a/avian/assets/illustrations/spizelloides-arborea-2.png b/avian/assets/illustrations/spizelloides-arborea-2.png
new file mode 100644
index 0000000..16ee4f9
Binary files /dev/null and b/avian/assets/illustrations/spizelloides-arborea-2.png differ
diff --git a/avian/assets/illustrations/spizelloides-arborea.png b/avian/assets/illustrations/spizelloides-arborea.png
new file mode 100644
index 0000000..ffbad51
Binary files /dev/null and b/avian/assets/illustrations/spizelloides-arborea.png differ
diff --git a/avian/assets/illustrations/stelgidopteryx-serripennis-2.png b/avian/assets/illustrations/stelgidopteryx-serripennis-2.png
new file mode 100644
index 0000000..89a2789
Binary files /dev/null and b/avian/assets/illustrations/stelgidopteryx-serripennis-2.png differ
diff --git a/avian/assets/illustrations/stelgidopteryx-serripennis.png b/avian/assets/illustrations/stelgidopteryx-serripennis.png
new file mode 100644
index 0000000..5921557
Binary files /dev/null and b/avian/assets/illustrations/stelgidopteryx-serripennis.png differ
diff --git a/avian/assets/illustrations/sterna-forsteri-2.png b/avian/assets/illustrations/sterna-forsteri-2.png
new file mode 100644
index 0000000..d2907b7
Binary files /dev/null and b/avian/assets/illustrations/sterna-forsteri-2.png differ
diff --git a/avian/assets/illustrations/sterna-forsteri.png b/avian/assets/illustrations/sterna-forsteri.png
new file mode 100644
index 0000000..941910c
Binary files /dev/null and b/avian/assets/illustrations/sterna-forsteri.png differ
diff --git a/avian/assets/illustrations/sterna-hirundo-2.png b/avian/assets/illustrations/sterna-hirundo-2.png
new file mode 100644
index 0000000..eb2fc74
Binary files /dev/null and b/avian/assets/illustrations/sterna-hirundo-2.png differ
diff --git a/avian/assets/illustrations/sterna-hirundo.png b/avian/assets/illustrations/sterna-hirundo.png
new file mode 100644
index 0000000..07750e8
Binary files /dev/null and b/avian/assets/illustrations/sterna-hirundo.png differ
diff --git a/avian/assets/illustrations/streptopelia-decaocto-2.png b/avian/assets/illustrations/streptopelia-decaocto-2.png
new file mode 100644
index 0000000..e2e0de8
Binary files /dev/null and b/avian/assets/illustrations/streptopelia-decaocto-2.png differ
diff --git a/avian/assets/illustrations/streptopelia-decaocto.png b/avian/assets/illustrations/streptopelia-decaocto.png
new file mode 100644
index 0000000..2037c42
Binary files /dev/null and b/avian/assets/illustrations/streptopelia-decaocto.png differ
diff --git a/avian/assets/illustrations/strix-occidentalis.png b/avian/assets/illustrations/strix-occidentalis.png
new file mode 100644
index 0000000..c5af1d1
Binary files /dev/null and b/avian/assets/illustrations/strix-occidentalis.png differ
diff --git a/avian/assets/illustrations/sturnella-neglecta-2.png b/avian/assets/illustrations/sturnella-neglecta-2.png
new file mode 100644
index 0000000..ea777f0
Binary files /dev/null and b/avian/assets/illustrations/sturnella-neglecta-2.png differ
diff --git a/avian/assets/illustrations/sturnella-neglecta.png b/avian/assets/illustrations/sturnella-neglecta.png
new file mode 100644
index 0000000..e0b6309
Binary files /dev/null and b/avian/assets/illustrations/sturnella-neglecta.png differ
diff --git a/avian/assets/illustrations/sturnus-vulgaris-2.png b/avian/assets/illustrations/sturnus-vulgaris-2.png
new file mode 100644
index 0000000..4a6adef
Binary files /dev/null and b/avian/assets/illustrations/sturnus-vulgaris-2.png differ
diff --git a/avian/assets/illustrations/sturnus-vulgaris.png b/avian/assets/illustrations/sturnus-vulgaris.png
new file mode 100644
index 0000000..dadb3f6
Binary files /dev/null and b/avian/assets/illustrations/sturnus-vulgaris.png differ
diff --git a/avian/assets/illustrations/tachycineta-bicolor-2.png b/avian/assets/illustrations/tachycineta-bicolor-2.png
new file mode 100644
index 0000000..0a6b9d3
Binary files /dev/null and b/avian/assets/illustrations/tachycineta-bicolor-2.png differ
diff --git a/avian/assets/illustrations/tachycineta-bicolor.png b/avian/assets/illustrations/tachycineta-bicolor.png
new file mode 100644
index 0000000..420bc27
Binary files /dev/null and b/avian/assets/illustrations/tachycineta-bicolor.png differ
diff --git a/avian/assets/illustrations/tachycineta-thalassina-2.png b/avian/assets/illustrations/tachycineta-thalassina-2.png
new file mode 100644
index 0000000..6cf3ec9
Binary files /dev/null and b/avian/assets/illustrations/tachycineta-thalassina-2.png differ
diff --git a/avian/assets/illustrations/tachycineta-thalassina.png b/avian/assets/illustrations/tachycineta-thalassina.png
new file mode 100644
index 0000000..bf7c405
Binary files /dev/null and b/avian/assets/illustrations/tachycineta-thalassina.png differ
diff --git a/avian/assets/illustrations/thalasseus-elegans-2.png b/avian/assets/illustrations/thalasseus-elegans-2.png
new file mode 100644
index 0000000..d9bf2bc
Binary files /dev/null and b/avian/assets/illustrations/thalasseus-elegans-2.png differ
diff --git a/avian/assets/illustrations/thalasseus-elegans.png b/avian/assets/illustrations/thalasseus-elegans.png
new file mode 100644
index 0000000..1a545ef
Binary files /dev/null and b/avian/assets/illustrations/thalasseus-elegans.png differ
diff --git a/avian/assets/illustrations/thryomanes-bewickii.png b/avian/assets/illustrations/thryomanes-bewickii.png
new file mode 100644
index 0000000..db341d0
Binary files /dev/null and b/avian/assets/illustrations/thryomanes-bewickii.png differ
diff --git a/avian/assets/illustrations/toxostoma-redivivum-2.png b/avian/assets/illustrations/toxostoma-redivivum-2.png
new file mode 100644
index 0000000..0fc9e76
Binary files /dev/null and b/avian/assets/illustrations/toxostoma-redivivum-2.png differ
diff --git a/avian/assets/illustrations/toxostoma-redivivum.png b/avian/assets/illustrations/toxostoma-redivivum.png
new file mode 100644
index 0000000..17c7c03
Binary files /dev/null and b/avian/assets/illustrations/toxostoma-redivivum.png differ
diff --git a/avian/assets/illustrations/tringa-semipalmata-2.png b/avian/assets/illustrations/tringa-semipalmata-2.png
new file mode 100644
index 0000000..cba3c10
Binary files /dev/null and b/avian/assets/illustrations/tringa-semipalmata-2.png differ
diff --git a/avian/assets/illustrations/tringa-semipalmata.png b/avian/assets/illustrations/tringa-semipalmata.png
new file mode 100644
index 0000000..0d24f9e
Binary files /dev/null and b/avian/assets/illustrations/tringa-semipalmata.png differ
diff --git a/avian/assets/illustrations/troglodytes-aedon.png b/avian/assets/illustrations/troglodytes-aedon.png
new file mode 100644
index 0000000..e32e766
Binary files /dev/null and b/avian/assets/illustrations/troglodytes-aedon.png differ
diff --git a/avian/assets/illustrations/troglodytes-pacificus.png b/avian/assets/illustrations/troglodytes-pacificus.png
new file mode 100644
index 0000000..fcff716
Binary files /dev/null and b/avian/assets/illustrations/troglodytes-pacificus.png differ
diff --git a/avian/assets/illustrations/turdus-migratorius-2.png b/avian/assets/illustrations/turdus-migratorius-2.png
new file mode 100644
index 0000000..3814a4c
Binary files /dev/null and b/avian/assets/illustrations/turdus-migratorius-2.png differ
diff --git a/avian/assets/illustrations/turdus-migratorius.png b/avian/assets/illustrations/turdus-migratorius.png
new file mode 100644
index 0000000..1552c95
Binary files /dev/null and b/avian/assets/illustrations/turdus-migratorius.png differ
diff --git a/avian/assets/illustrations/tyrannus-verticalis-2.png b/avian/assets/illustrations/tyrannus-verticalis-2.png
new file mode 100644
index 0000000..cd379f5
Binary files /dev/null and b/avian/assets/illustrations/tyrannus-verticalis-2.png differ
diff --git a/avian/assets/illustrations/tyrannus-verticalis.png b/avian/assets/illustrations/tyrannus-verticalis.png
new file mode 100644
index 0000000..349ceeb
Binary files /dev/null and b/avian/assets/illustrations/tyrannus-verticalis.png differ
diff --git a/avian/assets/illustrations/tyrannus-vociferans-2.png b/avian/assets/illustrations/tyrannus-vociferans-2.png
new file mode 100644
index 0000000..d791c83
Binary files /dev/null and b/avian/assets/illustrations/tyrannus-vociferans-2.png differ
diff --git a/avian/assets/illustrations/tyrannus-vociferans.png b/avian/assets/illustrations/tyrannus-vociferans.png
new file mode 100644
index 0000000..be6fde9
Binary files /dev/null and b/avian/assets/illustrations/tyrannus-vociferans.png differ
diff --git a/avian/assets/illustrations/tyto-alba-2.png b/avian/assets/illustrations/tyto-alba-2.png
new file mode 100644
index 0000000..a0686dd
Binary files /dev/null and b/avian/assets/illustrations/tyto-alba-2.png differ
diff --git a/avian/assets/illustrations/tyto-alba.png b/avian/assets/illustrations/tyto-alba.png
new file mode 100644
index 0000000..9f82a85
Binary files /dev/null and b/avian/assets/illustrations/tyto-alba.png differ
diff --git a/avian/assets/illustrations/urile-penicillatus-2.png b/avian/assets/illustrations/urile-penicillatus-2.png
new file mode 100644
index 0000000..25e6796
Binary files /dev/null and b/avian/assets/illustrations/urile-penicillatus-2.png differ
diff --git a/avian/assets/illustrations/urile-penicillatus.png b/avian/assets/illustrations/urile-penicillatus.png
new file mode 100644
index 0000000..2dd0b52
Binary files /dev/null and b/avian/assets/illustrations/urile-penicillatus.png differ
diff --git a/avian/assets/illustrations/vireo-bellii.png b/avian/assets/illustrations/vireo-bellii.png
new file mode 100644
index 0000000..1765850
Binary files /dev/null and b/avian/assets/illustrations/vireo-bellii.png differ
diff --git a/avian/assets/illustrations/vireo-cassinii.png b/avian/assets/illustrations/vireo-cassinii.png
new file mode 100644
index 0000000..71c61d8
Binary files /dev/null and b/avian/assets/illustrations/vireo-cassinii.png differ
diff --git a/avian/assets/illustrations/vireo-gilvus-2.png b/avian/assets/illustrations/vireo-gilvus-2.png
new file mode 100644
index 0000000..7d4797f
Binary files /dev/null and b/avian/assets/illustrations/vireo-gilvus-2.png differ
diff --git a/avian/assets/illustrations/vireo-gilvus.png b/avian/assets/illustrations/vireo-gilvus.png
new file mode 100644
index 0000000..acda919
Binary files /dev/null and b/avian/assets/illustrations/vireo-gilvus.png differ
diff --git a/avian/assets/illustrations/vireo-huttoni.png b/avian/assets/illustrations/vireo-huttoni.png
new file mode 100644
index 0000000..857aa49
Binary files /dev/null and b/avian/assets/illustrations/vireo-huttoni.png differ
diff --git a/avian/assets/illustrations/xanthocephalus-xanthocephalus-2.png b/avian/assets/illustrations/xanthocephalus-xanthocephalus-2.png
new file mode 100644
index 0000000..ed7919e
Binary files /dev/null and b/avian/assets/illustrations/xanthocephalus-xanthocephalus-2.png differ
diff --git a/avian/assets/illustrations/xanthocephalus-xanthocephalus.png b/avian/assets/illustrations/xanthocephalus-xanthocephalus.png
new file mode 100644
index 0000000..70f2e38
Binary files /dev/null and b/avian/assets/illustrations/xanthocephalus-xanthocephalus.png differ
diff --git a/avian/assets/illustrations/zenaida-asiatica-2.png b/avian/assets/illustrations/zenaida-asiatica-2.png
new file mode 100644
index 0000000..508c7c9
Binary files /dev/null and b/avian/assets/illustrations/zenaida-asiatica-2.png differ
diff --git a/avian/assets/illustrations/zenaida-asiatica.png b/avian/assets/illustrations/zenaida-asiatica.png
new file mode 100644
index 0000000..969c7fc
Binary files /dev/null and b/avian/assets/illustrations/zenaida-asiatica.png differ
diff --git a/avian/assets/illustrations/zenaida-macroura-2.png b/avian/assets/illustrations/zenaida-macroura-2.png
new file mode 100644
index 0000000..ec80e64
Binary files /dev/null and b/avian/assets/illustrations/zenaida-macroura-2.png differ
diff --git a/avian/assets/illustrations/zenaida-macroura.png b/avian/assets/illustrations/zenaida-macroura.png
new file mode 100644
index 0000000..0c8119d
Binary files /dev/null and b/avian/assets/illustrations/zenaida-macroura.png differ
diff --git a/avian/assets/illustrations/zonotrichia-atricapilla.png b/avian/assets/illustrations/zonotrichia-atricapilla.png
new file mode 100644
index 0000000..b2fb549
Binary files /dev/null and b/avian/assets/illustrations/zonotrichia-atricapilla.png differ
diff --git a/avian/assets/illustrations/zonotrichia-leucophrys-2.png b/avian/assets/illustrations/zonotrichia-leucophrys-2.png
new file mode 100644
index 0000000..bf9666a
Binary files /dev/null and b/avian/assets/illustrations/zonotrichia-leucophrys-2.png differ
diff --git a/avian/assets/illustrations/zonotrichia-leucophrys.png b/avian/assets/illustrations/zonotrichia-leucophrys.png
new file mode 100644
index 0000000..52f6140
Binary files /dev/null and b/avian/assets/illustrations/zonotrichia-leucophrys.png differ
diff --git a/avian/assets/illustrations/zonotrichia-querula.png b/avian/assets/illustrations/zonotrichia-querula.png
new file mode 100644
index 0000000..210ce8a
Binary files /dev/null and b/avian/assets/illustrations/zonotrichia-querula.png differ
diff --git a/avian/assets/sketches/agelaius-phoeniceus-2.png b/avian/assets/sketches/agelaius-phoeniceus-2.png
new file mode 100644
index 0000000..0acfd78
Binary files /dev/null and b/avian/assets/sketches/agelaius-phoeniceus-2.png differ
diff --git a/avian/assets/sketches/agelaius-phoeniceus.png b/avian/assets/sketches/agelaius-phoeniceus.png
new file mode 100644
index 0000000..e5d0ec9
Binary files /dev/null and b/avian/assets/sketches/agelaius-phoeniceus.png differ
diff --git a/avian/assets/sketches/aphelocoma-californica-2.png b/avian/assets/sketches/aphelocoma-californica-2.png
new file mode 100644
index 0000000..26d834c
Binary files /dev/null and b/avian/assets/sketches/aphelocoma-californica-2.png differ
diff --git a/avian/assets/sketches/aphelocoma-californica.png b/avian/assets/sketches/aphelocoma-californica.png
new file mode 100644
index 0000000..14b0559
Binary files /dev/null and b/avian/assets/sketches/aphelocoma-californica.png differ
diff --git a/avian/assets/sketches/baeolophus-inornatus.png b/avian/assets/sketches/baeolophus-inornatus.png
new file mode 100644
index 0000000..c69ce95
Binary files /dev/null and b/avian/assets/sketches/baeolophus-inornatus.png differ
diff --git a/avian/assets/sketches/bombycilla-cedrorum.png b/avian/assets/sketches/bombycilla-cedrorum.png
new file mode 100644
index 0000000..3b65a67
Binary files /dev/null and b/avian/assets/sketches/bombycilla-cedrorum.png differ
diff --git a/avian/assets/sketches/calypte-anna-2.png b/avian/assets/sketches/calypte-anna-2.png
new file mode 100644
index 0000000..c8a5b6d
Binary files /dev/null and b/avian/assets/sketches/calypte-anna-2.png differ
diff --git a/avian/assets/sketches/calypte-anna.png b/avian/assets/sketches/calypte-anna.png
new file mode 100644
index 0000000..a219e78
Binary files /dev/null and b/avian/assets/sketches/calypte-anna.png differ
diff --git a/avian/assets/sketches/cardellina-pusilla.png b/avian/assets/sketches/cardellina-pusilla.png
new file mode 100644
index 0000000..fcb0ff0
Binary files /dev/null and b/avian/assets/sketches/cardellina-pusilla.png differ
diff --git a/avian/assets/sketches/catharus-guttatus-2.png b/avian/assets/sketches/catharus-guttatus-2.png
new file mode 100644
index 0000000..50e9ab1
Binary files /dev/null and b/avian/assets/sketches/catharus-guttatus-2.png differ
diff --git a/avian/assets/sketches/catharus-guttatus.png b/avian/assets/sketches/catharus-guttatus.png
new file mode 100644
index 0000000..ae23443
Binary files /dev/null and b/avian/assets/sketches/catharus-guttatus.png differ
diff --git a/avian/assets/sketches/cistothorus-palustris-2.png b/avian/assets/sketches/cistothorus-palustris-2.png
new file mode 100644
index 0000000..7b2a4c0
Binary files /dev/null and b/avian/assets/sketches/cistothorus-palustris-2.png differ
diff --git a/avian/assets/sketches/cistothorus-palustris.png b/avian/assets/sketches/cistothorus-palustris.png
new file mode 100644
index 0000000..1270f66
Binary files /dev/null and b/avian/assets/sketches/cistothorus-palustris.png differ
diff --git a/avian/assets/sketches/columba-livia-2.png b/avian/assets/sketches/columba-livia-2.png
new file mode 100644
index 0000000..8d452ab
Binary files /dev/null and b/avian/assets/sketches/columba-livia-2.png differ
diff --git a/avian/assets/sketches/columba-livia.png b/avian/assets/sketches/columba-livia.png
new file mode 100644
index 0000000..e60f284
Binary files /dev/null and b/avian/assets/sketches/columba-livia.png differ
diff --git a/avian/assets/sketches/contopus-sordidulus.png b/avian/assets/sketches/contopus-sordidulus.png
new file mode 100644
index 0000000..d2d6e98
Binary files /dev/null and b/avian/assets/sketches/contopus-sordidulus.png differ
diff --git a/avian/assets/sketches/corvus-brachyrhynchos-2.png b/avian/assets/sketches/corvus-brachyrhynchos-2.png
new file mode 100644
index 0000000..5adcb43
Binary files /dev/null and b/avian/assets/sketches/corvus-brachyrhynchos-2.png differ
diff --git a/avian/assets/sketches/corvus-brachyrhynchos.png b/avian/assets/sketches/corvus-brachyrhynchos.png
new file mode 100644
index 0000000..18409c1
Binary files /dev/null and b/avian/assets/sketches/corvus-brachyrhynchos.png differ
diff --git a/avian/assets/sketches/corvus-corax-2.png b/avian/assets/sketches/corvus-corax-2.png
new file mode 100644
index 0000000..36cf994
Binary files /dev/null and b/avian/assets/sketches/corvus-corax-2.png differ
diff --git a/avian/assets/sketches/corvus-corax.png b/avian/assets/sketches/corvus-corax.png
new file mode 100644
index 0000000..0f0c0d4
Binary files /dev/null and b/avian/assets/sketches/corvus-corax.png differ
diff --git a/avian/assets/sketches/cyanocitta-stelleri-2.png b/avian/assets/sketches/cyanocitta-stelleri-2.png
new file mode 100644
index 0000000..130ba80
Binary files /dev/null and b/avian/assets/sketches/cyanocitta-stelleri-2.png differ
diff --git a/avian/assets/sketches/cyanocitta-stelleri.png b/avian/assets/sketches/cyanocitta-stelleri.png
new file mode 100644
index 0000000..0c29687
Binary files /dev/null and b/avian/assets/sketches/cyanocitta-stelleri.png differ
diff --git a/avian/assets/sketches/empidonax-difficilis.png b/avian/assets/sketches/empidonax-difficilis.png
new file mode 100644
index 0000000..58141f1
Binary files /dev/null and b/avian/assets/sketches/empidonax-difficilis.png differ
diff --git a/avian/assets/sketches/euphagus-cyanocephalus.png b/avian/assets/sketches/euphagus-cyanocephalus.png
new file mode 100644
index 0000000..f7fab9d
Binary files /dev/null and b/avian/assets/sketches/euphagus-cyanocephalus.png differ
diff --git a/avian/assets/sketches/geothlypis-trichas-2.png b/avian/assets/sketches/geothlypis-trichas-2.png
new file mode 100644
index 0000000..30d18b9
Binary files /dev/null and b/avian/assets/sketches/geothlypis-trichas-2.png differ
diff --git a/avian/assets/sketches/geothlypis-trichas.png b/avian/assets/sketches/geothlypis-trichas.png
new file mode 100644
index 0000000..0e7cf18
Binary files /dev/null and b/avian/assets/sketches/geothlypis-trichas.png differ
diff --git a/avian/assets/sketches/haemorhous-mexicanus-2.png b/avian/assets/sketches/haemorhous-mexicanus-2.png
new file mode 100644
index 0000000..c28f422
Binary files /dev/null and b/avian/assets/sketches/haemorhous-mexicanus-2.png differ
diff --git a/avian/assets/sketches/haemorhous-mexicanus.png b/avian/assets/sketches/haemorhous-mexicanus.png
new file mode 100644
index 0000000..2be7d26
Binary files /dev/null and b/avian/assets/sketches/haemorhous-mexicanus.png differ
diff --git a/avian/assets/sketches/haemorhous-purpureus.png b/avian/assets/sketches/haemorhous-purpureus.png
new file mode 100644
index 0000000..d2d224a
Binary files /dev/null and b/avian/assets/sketches/haemorhous-purpureus.png differ
diff --git a/avian/assets/sketches/icterus-bullockii.png b/avian/assets/sketches/icterus-bullockii.png
new file mode 100644
index 0000000..5f5205e
Binary files /dev/null and b/avian/assets/sketches/icterus-bullockii.png differ
diff --git a/avian/assets/sketches/icterus-cucullatus-2.png b/avian/assets/sketches/icterus-cucullatus-2.png
new file mode 100644
index 0000000..2f95c1c
Binary files /dev/null and b/avian/assets/sketches/icterus-cucullatus-2.png differ
diff --git a/avian/assets/sketches/icterus-cucullatus.png b/avian/assets/sketches/icterus-cucullatus.png
new file mode 100644
index 0000000..ec628ea
Binary files /dev/null and b/avian/assets/sketches/icterus-cucullatus.png differ
diff --git a/avian/assets/sketches/junco-hyemalis-2.png b/avian/assets/sketches/junco-hyemalis-2.png
new file mode 100644
index 0000000..31022ff
Binary files /dev/null and b/avian/assets/sketches/junco-hyemalis-2.png differ
diff --git a/avian/assets/sketches/junco-hyemalis.png b/avian/assets/sketches/junco-hyemalis.png
new file mode 100644
index 0000000..baa3758
Binary files /dev/null and b/avian/assets/sketches/junco-hyemalis.png differ
diff --git a/avian/assets/sketches/larus-occidentalis-2.png b/avian/assets/sketches/larus-occidentalis-2.png
new file mode 100644
index 0000000..ca18ec4
Binary files /dev/null and b/avian/assets/sketches/larus-occidentalis-2.png differ
diff --git a/avian/assets/sketches/larus-occidentalis.png b/avian/assets/sketches/larus-occidentalis.png
new file mode 100644
index 0000000..cbca671
Binary files /dev/null and b/avian/assets/sketches/larus-occidentalis.png differ
diff --git a/avian/assets/sketches/leiothlypis-celata.png b/avian/assets/sketches/leiothlypis-celata.png
new file mode 100644
index 0000000..f01a636
Binary files /dev/null and b/avian/assets/sketches/leiothlypis-celata.png differ
diff --git a/avian/assets/sketches/melospiza-melodia-2.png b/avian/assets/sketches/melospiza-melodia-2.png
new file mode 100644
index 0000000..575332c
Binary files /dev/null and b/avian/assets/sketches/melospiza-melodia-2.png differ
diff --git a/avian/assets/sketches/melospiza-melodia.png b/avian/assets/sketches/melospiza-melodia.png
new file mode 100644
index 0000000..2796343
Binary files /dev/null and b/avian/assets/sketches/melospiza-melodia.png differ
diff --git a/avian/assets/sketches/melozone-crissalis.png b/avian/assets/sketches/melozone-crissalis.png
new file mode 100644
index 0000000..100c63e
Binary files /dev/null and b/avian/assets/sketches/melozone-crissalis.png differ
diff --git a/avian/assets/sketches/mimus-polyglottos-2.png b/avian/assets/sketches/mimus-polyglottos-2.png
new file mode 100644
index 0000000..5607765
Binary files /dev/null and b/avian/assets/sketches/mimus-polyglottos-2.png differ
diff --git a/avian/assets/sketches/mimus-polyglottos.png b/avian/assets/sketches/mimus-polyglottos.png
new file mode 100644
index 0000000..8e32244
Binary files /dev/null and b/avian/assets/sketches/mimus-polyglottos.png differ
diff --git a/avian/assets/sketches/molothrus-ater-2.png b/avian/assets/sketches/molothrus-ater-2.png
new file mode 100644
index 0000000..c8e65c2
Binary files /dev/null and b/avian/assets/sketches/molothrus-ater-2.png differ
diff --git a/avian/assets/sketches/molothrus-ater.png b/avian/assets/sketches/molothrus-ater.png
new file mode 100644
index 0000000..9603ddd
Binary files /dev/null and b/avian/assets/sketches/molothrus-ater.png differ
diff --git a/avian/assets/sketches/passer-domesticus-2.png b/avian/assets/sketches/passer-domesticus-2.png
new file mode 100644
index 0000000..0ea3ca0
Binary files /dev/null and b/avian/assets/sketches/passer-domesticus-2.png differ
diff --git a/avian/assets/sketches/passer-domesticus.png b/avian/assets/sketches/passer-domesticus.png
new file mode 100644
index 0000000..ce4fcfb
Binary files /dev/null and b/avian/assets/sketches/passer-domesticus.png differ
diff --git a/avian/assets/sketches/pipilo-maculatus.png b/avian/assets/sketches/pipilo-maculatus.png
new file mode 100644
index 0000000..c134a2e
Binary files /dev/null and b/avian/assets/sketches/pipilo-maculatus.png differ
diff --git a/avian/assets/sketches/poecile-rufescens-2.png b/avian/assets/sketches/poecile-rufescens-2.png
new file mode 100644
index 0000000..f67eb32
Binary files /dev/null and b/avian/assets/sketches/poecile-rufescens-2.png differ
diff --git a/avian/assets/sketches/poecile-rufescens.png b/avian/assets/sketches/poecile-rufescens.png
new file mode 100644
index 0000000..58bad4d
Binary files /dev/null and b/avian/assets/sketches/poecile-rufescens.png differ
diff --git a/avian/assets/sketches/psaltriparus-minimus.png b/avian/assets/sketches/psaltriparus-minimus.png
new file mode 100644
index 0000000..0272dd8
Binary files /dev/null and b/avian/assets/sketches/psaltriparus-minimus.png differ
diff --git a/avian/assets/sketches/sayornis-nigricans-2.png b/avian/assets/sketches/sayornis-nigricans-2.png
new file mode 100644
index 0000000..678e5d3
Binary files /dev/null and b/avian/assets/sketches/sayornis-nigricans-2.png differ
diff --git a/avian/assets/sketches/sayornis-nigricans.png b/avian/assets/sketches/sayornis-nigricans.png
new file mode 100644
index 0000000..13188b3
Binary files /dev/null and b/avian/assets/sketches/sayornis-nigricans.png differ
diff --git a/avian/assets/sketches/selasphorus-sasin-2.png b/avian/assets/sketches/selasphorus-sasin-2.png
new file mode 100644
index 0000000..303e351
Binary files /dev/null and b/avian/assets/sketches/selasphorus-sasin-2.png differ
diff --git a/avian/assets/sketches/selasphorus-sasin.png b/avian/assets/sketches/selasphorus-sasin.png
new file mode 100644
index 0000000..801b1c6
Binary files /dev/null and b/avian/assets/sketches/selasphorus-sasin.png differ
diff --git a/avian/assets/sketches/setophaga-coronata.png b/avian/assets/sketches/setophaga-coronata.png
new file mode 100644
index 0000000..ca5c6ab
Binary files /dev/null and b/avian/assets/sketches/setophaga-coronata.png differ
diff --git a/avian/assets/sketches/setophaga-townsendi.png b/avian/assets/sketches/setophaga-townsendi.png
new file mode 100644
index 0000000..9484b0e
Binary files /dev/null and b/avian/assets/sketches/setophaga-townsendi.png differ
diff --git a/avian/assets/sketches/sialia-mexicana.png b/avian/assets/sketches/sialia-mexicana.png
new file mode 100644
index 0000000..bd44c64
Binary files /dev/null and b/avian/assets/sketches/sialia-mexicana.png differ
diff --git a/avian/assets/sketches/spinus-pinus-2.png b/avian/assets/sketches/spinus-pinus-2.png
new file mode 100644
index 0000000..585c81f
Binary files /dev/null and b/avian/assets/sketches/spinus-pinus-2.png differ
diff --git a/avian/assets/sketches/spinus-pinus.png b/avian/assets/sketches/spinus-pinus.png
new file mode 100644
index 0000000..54e1f6a
Binary files /dev/null and b/avian/assets/sketches/spinus-pinus.png differ
diff --git a/avian/assets/sketches/spinus-psaltria.png b/avian/assets/sketches/spinus-psaltria.png
new file mode 100644
index 0000000..5df58b9
Binary files /dev/null and b/avian/assets/sketches/spinus-psaltria.png differ
diff --git a/avian/assets/sketches/spinus-tristis-2.png b/avian/assets/sketches/spinus-tristis-2.png
new file mode 100644
index 0000000..124954d
Binary files /dev/null and b/avian/assets/sketches/spinus-tristis-2.png differ
diff --git a/avian/assets/sketches/spinus-tristis.png b/avian/assets/sketches/spinus-tristis.png
new file mode 100644
index 0000000..791b790
Binary files /dev/null and b/avian/assets/sketches/spinus-tristis.png differ
diff --git a/avian/assets/sketches/streptopelia-decaocto-2.png b/avian/assets/sketches/streptopelia-decaocto-2.png
new file mode 100644
index 0000000..0f1deff
Binary files /dev/null and b/avian/assets/sketches/streptopelia-decaocto-2.png differ
diff --git a/avian/assets/sketches/streptopelia-decaocto.png b/avian/assets/sketches/streptopelia-decaocto.png
new file mode 100644
index 0000000..3a5452c
Binary files /dev/null and b/avian/assets/sketches/streptopelia-decaocto.png differ
diff --git a/avian/assets/sketches/sturnus-vulgaris-2.png b/avian/assets/sketches/sturnus-vulgaris-2.png
new file mode 100644
index 0000000..29e12df
Binary files /dev/null and b/avian/assets/sketches/sturnus-vulgaris-2.png differ
diff --git a/avian/assets/sketches/sturnus-vulgaris.png b/avian/assets/sketches/sturnus-vulgaris.png
new file mode 100644
index 0000000..64dcbf8
Binary files /dev/null and b/avian/assets/sketches/sturnus-vulgaris.png differ
diff --git a/avian/assets/sketches/thryomanes-bewickii.png b/avian/assets/sketches/thryomanes-bewickii.png
new file mode 100644
index 0000000..934f78d
Binary files /dev/null and b/avian/assets/sketches/thryomanes-bewickii.png differ
diff --git a/avian/assets/sketches/toxostoma-redivivum.png b/avian/assets/sketches/toxostoma-redivivum.png
new file mode 100644
index 0000000..82c0911
Binary files /dev/null and b/avian/assets/sketches/toxostoma-redivivum.png differ
diff --git a/avian/assets/sketches/troglodytes-pacificus.png b/avian/assets/sketches/troglodytes-pacificus.png
new file mode 100644
index 0000000..253176a
Binary files /dev/null and b/avian/assets/sketches/troglodytes-pacificus.png differ
diff --git a/avian/assets/sketches/turdus-migratorius-2.png b/avian/assets/sketches/turdus-migratorius-2.png
new file mode 100644
index 0000000..17683f2
Binary files /dev/null and b/avian/assets/sketches/turdus-migratorius-2.png differ
diff --git a/avian/assets/sketches/turdus-migratorius.png b/avian/assets/sketches/turdus-migratorius.png
new file mode 100644
index 0000000..a3be5c0
Binary files /dev/null and b/avian/assets/sketches/turdus-migratorius.png differ
diff --git a/avian/assets/sketches/zenaida-macroura-2.png b/avian/assets/sketches/zenaida-macroura-2.png
new file mode 100644
index 0000000..c45e251
Binary files /dev/null and b/avian/assets/sketches/zenaida-macroura-2.png differ
diff --git a/avian/assets/sketches/zenaida-macroura.png b/avian/assets/sketches/zenaida-macroura.png
new file mode 100644
index 0000000..1cd5452
Binary files /dev/null and b/avian/assets/sketches/zenaida-macroura.png differ
diff --git a/avian/assets/sketches/zonotrichia-atricapilla.png b/avian/assets/sketches/zonotrichia-atricapilla.png
new file mode 100644
index 0000000..62e8d6f
Binary files /dev/null and b/avian/assets/sketches/zonotrichia-atricapilla.png differ
diff --git a/avian/assets/sketches/zonotrichia-leucophrys-2.png b/avian/assets/sketches/zonotrichia-leucophrys-2.png
new file mode 100644
index 0000000..b692211
Binary files /dev/null and b/avian/assets/sketches/zonotrichia-leucophrys-2.png differ
diff --git a/avian/assets/sketches/zonotrichia-leucophrys.png b/avian/assets/sketches/zonotrichia-leucophrys.png
new file mode 100644
index 0000000..70b5597
Binary files /dev/null and b/avian/assets/sketches/zonotrichia-leucophrys.png differ
diff --git a/avian/caddy/avian.caddy b/avian/caddy/avian.caddy
new file mode 100644
index 0000000..6ec6330
--- /dev/null
+++ b/avian/caddy/avian.caddy
@@ -0,0 +1,37 @@
+# AvianVisitors — Caddy snippet.
+# Drop into /etc/caddy/conf.d/ and add `import /etc/caddy/conf.d/*.caddy`
+# to the main Caddyfile (the installer does this for you).
+#
+# Default: serves the collage locally at http://birdnet.local/collage/
+# with no auth. For the optional Cloudflare/HA forwarded deployment,
+# see ../forwarding/.
+
+(avian_common) {
+ # CORS — collage is a single-origin static app; loose for the JSON
+ # endpoints so HA dashboards etc. can read them.
+ @json path /api/*.json
+ header @json {
+ Access-Control-Allow-Origin "*"
+ Cache-Control "no-cache"
+ }
+}
+
+# Frontend lives at http://birdnet.local/collage/
+http://birdnet.local {
+ import avian_common
+
+ # Static collage UI
+ handle_path /collage/* {
+ root * /var/www/avian
+ file_server
+ }
+ redir /collage /collage/
+
+ # PHP shims for recent.json / lifelist.json / firstseen.json /
+ # timeseries.json — served from BirdNET-Pi's existing PHP root.
+ handle_path /api/* {
+ root * /home/monalisa/BirdSongs/Extracted
+ php_fastcgi unix//run/php/php8.2-fpm.sock
+ file_server
+ }
+}
diff --git a/avian/forwarding/README.md b/avian/forwarding/README.md
new file mode 100644
index 0000000..183c078
--- /dev/null
+++ b/avian/forwarding/README.md
@@ -0,0 +1,99 @@
+# Optional: forwarding the collage off your local network
+
+Default install hosts the collage at `http://birdnet.local/collage/` on
+your LAN with no auth. If you want it accessible from anywhere — or
+piped into Home Assistant / MQTT — pick one of the recipes below.
+
+Each recipe is independent. Skip what you don't need.
+
+---
+
+## 1. Cloudflare Tunnel (recommended for public access)
+
+Gives you a public HTTPS URL with no port forwarding and no exposed
+home IP. Free Cloudflare account required.
+
+Install `cloudflared` on the Pi:
+
+```bash
+sudo mkdir -p /usr/share/keyrings
+curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg \
+ | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
+echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main' \
+ | sudo tee /etc/apt/sources.list.d/cloudflared.list
+sudo apt update && sudo apt install -y cloudflared
+```
+
+Authenticate + create the tunnel:
+
+```bash
+cloudflared tunnel login
+cloudflared tunnel create birds
+```
+
+Add a public route — pick a hostname on a zone you own:
+
+```bash
+cloudflared tunnel route dns birds birds.your-domain.com
+```
+
+Configure the tunnel to point at the local Caddy:
+
+```bash
+sudo cp avian/forwarding/cloudflared.yml /etc/cloudflared/config.yml
+# edit /etc/cloudflared/config.yml — set `tunnel:` to your tunnel UUID
+sudo cloudflared service install
+sudo systemctl restart cloudflared
+```
+
+**Adding password protection on the public URL.** With Cloudflare in
+front, gate the public endpoint via Cloudflare Access (zero-trust
+free tier supports up to 50 users) — see Cloudflare docs. The local
+LAN URL remains unprotected. If you'd rather use HTTP Basic auth on
+Caddy itself, see [forwarding/caddy-auth.caddy](caddy-auth.caddy).
+
+---
+
+## 2. Home Assistant — surface latest detection as a sensor
+
+Add to `configuration.yaml`:
+
+```yaml
+rest:
+ - resource: http://birdnet.local/api/recent.json?hours=1
+ scan_interval: 60
+ sensor:
+ - name: "Latest Bird"
+ value_template: >
+ {% set top = value_json.species | sort(attribute='last_seen', reverse=true) | first %}
+ {{ top.com if top else 'none' }}
+ json_attributes_path: "$.species[0]"
+ json_attributes:
+ - sci
+ - n
+ - last_seen
+ - best_conf
+```
+
+Use the sensor in automations — flash a light when a new species is
+heard, etc.
+
+---
+
+## 3. MQTT — fan out detections to other services
+
+If you already run an MQTT broker, publish every new detection.
+Install `paho-mqtt` and run the bridge:
+
+```bash
+sudo pip3 install paho-mqtt --break-system-packages
+cp avian/forwarding/mqtt-bridge.py ~/avian-mqtt.py
+# edit ~/avian-mqtt.py — broker host, topic prefix
+sudo cp avian/forwarding/avian-mqtt.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now avian-mqtt
+```
+
+The bridge polls `/api/recent.json?hours=1` once a minute and
+publishes new species under `birdnet/` with the full record as
+JSON payload.
diff --git a/avian/forwarding/avian-mqtt.service b/avian/forwarding/avian-mqtt.service
new file mode 100644
index 0000000..2b59be0
--- /dev/null
+++ b/avian/forwarding/avian-mqtt.service
@@ -0,0 +1,12 @@
+[Unit]
+Description=AvianVisitors MQTT bridge
+After=network-online.target
+
+[Service]
+Type=simple
+ExecStart=/usr/bin/python3 /home/%i/avian-mqtt.py
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target
diff --git a/avian/forwarding/caddy-auth.caddy b/avian/forwarding/caddy-auth.caddy
new file mode 100644
index 0000000..74872af
--- /dev/null
+++ b/avian/forwarding/caddy-auth.caddy
@@ -0,0 +1,19 @@
+# Optional Basic-auth gate for the collage.
+# Use only if you're NOT putting Cloudflare Access in front of the
+# public URL. Replace the bcrypt hash below — generate via:
+# caddy hash-password --plaintext 'your-pass'
+#
+# Drop this into /etc/caddy/conf.d/ alongside avian.caddy and reload.
+
+(avian_basicauth) {
+ basic_auth {
+ # username bcrypt-hash
+ avian $2a$14$REPLACE_WITH_HASH_FROM_caddy_hash-password
+ }
+}
+
+# Example: gate only the public hostname, leave LAN open.
+# https://birds.your-domain.com {
+# import avian_basicauth
+# reverse_proxy localhost:80
+# }
diff --git a/avian/forwarding/cloudflared.yml b/avian/forwarding/cloudflared.yml
new file mode 100644
index 0000000..6ffcb6a
--- /dev/null
+++ b/avian/forwarding/cloudflared.yml
@@ -0,0 +1,11 @@
+# Cloudflare Tunnel config — copy to /etc/cloudflared/config.yml and
+# replace TUNNEL_UUID with the value printed by `cloudflared tunnel create`.
+tunnel: TUNNEL_UUID
+credentials-file: /etc/cloudflared/TUNNEL_UUID.json
+
+ingress:
+ # Public collage — points at the local Caddy on port 80.
+ - hostname: birds.your-domain.com
+ service: http://localhost:80
+ # Catch-all required by cloudflared
+ - service: http_status:404
diff --git a/avian/forwarding/mqtt-bridge.py b/avian/forwarding/mqtt-bridge.py
new file mode 100755
index 0000000..75d74bf
--- /dev/null
+++ b/avian/forwarding/mqtt-bridge.py
@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Poll /api/recent.json on the Pi once a minute and publish each new
+detection to MQTT. Edit BROKER, TOPIC_PREFIX, and PI_URL below."""
+import json
+import time
+import urllib.request
+import paho.mqtt.client as mqtt # sudo pip3 install paho-mqtt
+
+BROKER = "homeassistant.local"
+PORT = 1883
+USER = ""
+PASSWORD = ""
+TOPIC_PREFIX = "birdnet"
+PI_URL = "http://birdnet.local/api/recent.json?hours=1"
+
+seen_keys: set[str] = set()
+
+def slugify(s: str) -> str:
+ return "".join(c.lower() if c.isalnum() else "-" for c in s).strip("-")
+
+def loop(client: mqtt.Client) -> None:
+ while True:
+ try:
+ with urllib.request.urlopen(PI_URL, timeout=10) as r:
+ payload = json.loads(r.read())
+ for s in payload.get("species", []):
+ key = f"{s['sci']}|{s.get('last_seen','')}"
+ if key in seen_keys:
+ continue
+ seen_keys.add(key)
+ topic = f"{TOPIC_PREFIX}/{slugify(s['sci'])}"
+ client.publish(topic, json.dumps(s), qos=0, retain=False)
+ print(f"published {topic}: {s.get('com')}")
+ except Exception as e:
+ print(f"poll error: {e}")
+ time.sleep(60)
+
+def main() -> None:
+ client = mqtt.Client()
+ if USER:
+ client.username_pw_set(USER, PASSWORD)
+ client.connect(BROKER, PORT, keepalive=60)
+ client.loop_start()
+ loop(client)
+
+if __name__ == "__main__":
+ main()
diff --git a/avian/frontend/apt.js b/avian/frontend/apt.js
new file mode 100644
index 0000000..3af0ad0
--- /dev/null
+++ b/avian/frontend/apt.js
@@ -0,0 +1,465 @@
+/* AvianVisitors — bird collage frontend.
+ *
+ * Renders three views over BirdNET-Pi detections:
+ * collage — mask-packed cluster of species illustrations, sized by
+ * count. Layout normalises so all birds always fit on
+ * every viewport.
+ * stats — per-species histogram across the selected time window.
+ * atlas — alphabet of all detected species with detail modal.
+ *
+ * Reads four JSON endpoints exposed by the Pi (PHP shims in ../api/):
+ * GET /api/recent.json?hours=N — species + counts in window
+ * GET /api/lifelist.json — all species ever detected
+ * GET /api/firstseen.json — earliest detection per species
+ * GET /api/timeseries.json?days=D — daily counts per species
+ *
+ * Plus two media proxies (also via PHP):
+ * GET /api/img?sci=X[&com=Y] — bird illustration
+ * GET /api/recording?sci=X — most-recent mp3
+ * GET /api/spectrogram?sci=X — matching spectrogram png
+ *
+ * Local-network deploys ship without auth. The PHP shims accept the
+ * X-AvianVisitors-Token header for the optional Cloudflare-forwarded
+ * deployment — see ../forwarding/.
+ */
+(function () {
+ 'use strict';
+
+ // ---- Config ----
+ // API_BASE: where the JSON endpoints live. Default '/' works when
+ // Caddy mounts the frontend at the same host as the API. Override
+ // with window.AV_API_BASE if you split origins.
+ var API_BASE = (window.AV_API_BASE || '').replace(/\/$/, '');
+ var IMG_VERSION = '1'; // bump after running scripts/pregen.py
+
+ function api(p) { return API_BASE + p; }
+ function readLS(k, d) { try { return localStorage.getItem(k) || d; } catch (e) { return d; } }
+ function writeLS(k, v) { try { localStorage.setItem(k, v); } catch (e) {} }
+ function fetchJson(u) { return fetch(u, { cache: 'no-store' }).then(function (r) { return r.json(); }); }
+
+ // ---- State ----
+ var DATA = {
+ recent: null, // /api/recent.json?hours=N (refetched on picker change)
+ lifelist: null, // /api/lifelist.json
+ firstseen: null, // /api/firstseen.json
+ timeseries: null, // /api/timeseries.json
+ };
+ var MASKS = null, DIMS = null;
+ var currentHours = +readLS('av:window', '24') || 24;
+
+ // ---- Boot: load mask/dim registries, then first data pull ----
+ Promise.all([
+ fetchJson(api('/avian/masks.json')).then(function (j) { MASKS = j; }),
+ fetchJson(api('/avian/dims.json')).then(function (j) { DIMS = j; }),
+ ]).then(function () {
+ bindUI();
+ refreshAll();
+ setInterval(refreshRecent, 60000); // poll for new detections every min
+ }).catch(function (e) { console.error('boot failed', e); });
+
+ // ---- UI bindings ----
+ var slider = document.getElementById('slider');
+ var winPick = document.getElementById('winPick');
+ var views = document.querySelectorAll('.view');
+ function syncPill(container) {
+ var pill = container.querySelector('.seg-pill');
+ var active = container.querySelector('button[aria-current="true"]');
+ if (!pill || !active) return;
+ pill.style.width = active.offsetWidth + 'px';
+ pill.style.transform = 'translateX(' + active.offsetLeft + 'px)';
+ }
+ function syncAllPills() {
+ [slider, winPick, document.getElementById('atlasSort')].forEach(function (c) { if (c) syncPill(c); });
+ }
+ function bindUI() {
+ // View slider
+ [].slice.call(slider.querySelectorAll('button')).forEach(function (b) {
+ b.addEventListener('click', function () {
+ [].slice.call(slider.querySelectorAll('button')).forEach(function (x) {
+ x.setAttribute('aria-current', x === b ? 'true' : 'false');
+ });
+ var i = +b.dataset.i;
+ views.forEach(function (v) { v.hidden = +v.dataset.view !== i; });
+ syncPill(slider);
+ if (i === 0) renderCollageFromData();
+ if (i === 1) drawHistograms();
+ if (i === 2) renderAtlas();
+ });
+ });
+ // Window picker
+ [].slice.call(winPick.querySelectorAll('button')).forEach(function (b) {
+ b.setAttribute('aria-current', (+b.dataset.h === currentHours) ? 'true' : 'false');
+ b.addEventListener('click', function () {
+ [].slice.call(winPick.querySelectorAll('button')).forEach(function (x) {
+ x.setAttribute('aria-current', x === b ? 'true' : 'false');
+ });
+ currentHours = +b.dataset.h;
+ writeLS('av:window', String(currentHours));
+ syncPill(winPick);
+ refreshRecent();
+ });
+ });
+ // Atlas sort
+ var atlasEl = document.getElementById('atlasSort');
+ [].slice.call(atlasEl.querySelectorAll('button')).forEach(function (b) {
+ b.addEventListener('click', function () {
+ [].slice.call(atlasEl.querySelectorAll('button')).forEach(function (x) {
+ x.setAttribute('aria-current', x === b ? 'true' : 'false');
+ });
+ writeLS('av:atlasSort', b.dataset.sort);
+ syncPill(atlasEl);
+ renderAtlas();
+ });
+ });
+ // About modal
+ document.getElementById('aboutLink').addEventListener('click', function () {
+ document.getElementById('about-modal').setAttribute('aria-hidden', 'false');
+ });
+ document.querySelectorAll('[data-close]').forEach(function (el) {
+ el.addEventListener('click', function () {
+ document.getElementById('about-modal').setAttribute('aria-hidden', 'true');
+ });
+ });
+ // Resize: re-pack collage and re-pill
+ var rT;
+ window.addEventListener('resize', function () {
+ clearTimeout(rT);
+ rT = setTimeout(function () {
+ syncAllPills();
+ renderCollageFromData();
+ drawHistograms();
+ }, 120);
+ });
+ setTimeout(syncAllPills, 60);
+ }
+
+ // ---- Data fetch ----
+ function refreshAll() {
+ var h = currentHours;
+ return Promise.all([
+ fetchJson(api('/api/lifelist.json')).catch(function () { return null; }),
+ fetchJson(api('/api/firstseen.json')).catch(function () { return null; }),
+ fetchJson(api('/api/timeseries.json?days=30')).catch(function () { return null; }),
+ fetchJson(api('/api/recent.json?hours=' + h)).catch(function () { return null; }),
+ ]).then(function (parts) {
+ DATA.lifelist = parts[0];
+ DATA.firstseen = parts[1];
+ DATA.timeseries = parts[2];
+ if (parts[3] && h === currentHours) DATA.recent = parts[3];
+ renderCollageFromData();
+ drawHistograms();
+ });
+ }
+ function refreshRecent() {
+ var h = currentHours;
+ return fetchJson(api('/api/recent.json?hours=' + h)).then(function (j) {
+ if (h !== currentHours) return;
+ DATA.recent = j;
+ renderCollageFromData();
+ drawHistograms();
+ }).catch(function () {});
+ }
+
+ // ---- Mask + slug helpers ----
+ var maskCache = {};
+ function loadMask(slug) {
+ if (maskCache[slug]) return maskCache[slug];
+ var rec = MASKS[slug];
+ if (!rec) return null;
+ var bytes = atob(rec.bits);
+ var w = rec.w, h = rec.h;
+ var cells = [];
+ for (var y = 0; y < h; y++) {
+ for (var x = 0; x < w; x++) {
+ var i = y * w + x;
+ var b = bytes.charCodeAt(i >> 3);
+ if ((b >> (7 - (i & 7))) & 1) cells.push([x, y]);
+ }
+ }
+ return (maskCache[slug] = { w: w, h: h, cells: cells });
+ }
+ function slugify(sci) {
+ return sci.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+ }
+ function aspect(sci) {
+ var d = DIMS[slugify(sci)];
+ return d ? d[0] / d[1] : 1.4;
+ }
+
+ // ---- Collage layout (mask-aware, viewport-budget) ----
+ //
+ // Each species ships a low-res alpha mask. We maintain an occupancy
+ // grid at viewport resolution; for each tile we spiral outward from
+ // the cluster center and pick the closest non-overlapping placement.
+ // Total area is normalised so the entire cluster fits any viewport,
+ // and we iterate shrink+repack until every bird lands on-screen.
+ function tuning(n) {
+ return {
+ packingBudgetFrac: n <= 4 ? 0.46 : n <= 12 ? 0.40 : n <= 24 ? 0.34 : 0.28,
+ countExp: 0.65,
+ minTileAreaFrac: n <= 8 ? 0.0100 : n <= 20 ? 0.0075 : 0.0055,
+ ellipseAspectBias: 2.1,
+ };
+ }
+ var GRID_STRIDE = 4;
+
+ function maskPack(tiles, W, H, ellipseBias) {
+ var GW = Math.ceil(W / GRID_STRIDE) + 2;
+ var GH = Math.ceil(H / GRID_STRIDE) + 2;
+ var grid = new Uint8Array(GW * GH);
+
+ function cellRange(t, tx, ty, c) {
+ var sx = t.fullW / t.mask.w, sy = t.fullH / t.mask.h;
+ var x0 = (tx + c[0] * sx) / GRID_STRIDE | 0;
+ var y0 = (ty + c[1] * sy) / GRID_STRIDE | 0;
+ var x1 = (tx + (c[0] + 1) * sx) / GRID_STRIDE | 0;
+ var y1 = (ty + (c[1] + 1) * sy) / GRID_STRIDE | 0;
+ if (x0 < 0) x0 = 0; if (y0 < 0) y0 = 0;
+ if (x1 >= GW) x1 = GW - 1; if (y1 >= GH) y1 = GH - 1;
+ return [x0, y0, x1, y1];
+ }
+ function collides(t, tx, ty) {
+ var cs = t.mask.cells;
+ for (var i = 0; i < cs.length; i++) {
+ var r = cellRange(t, tx, ty, cs[i]);
+ for (var gy = r[1]; gy <= r[3]; gy++) {
+ var off = gy * GW;
+ for (var gx = r[0]; gx <= r[2]; gx++) if (grid[off + gx]) return true;
+ }
+ }
+ return false;
+ }
+ function stamp(t, tx, ty) {
+ var cs = t.mask.cells;
+ for (var i = 0; i < cs.length; i++) {
+ var r = cellRange(t, tx, ty, cs[i]);
+ for (var gy = r[1]; gy <= r[3]; gy++) {
+ var off = gy * GW;
+ for (var gx = r[0]; gx <= r[2]; gx++) grid[off + gx] = 1;
+ }
+ }
+ }
+
+ var rand = mulberry32(0x9E3779B1);
+ var placed = [];
+ var comX = W / 2, comY = H / 2;
+ tiles.sort(function (a, b) { return (b.fullW * b.fullH) - (a.fullW * a.fullH); });
+ for (var ti = 0; ti < tiles.length; ti++) {
+ var t = tiles[ti];
+ var bestCost = Infinity, best = null;
+ var rings = Math.max(W, H);
+ for (var r = 0; r < rings; r += GRID_STRIDE * 2) {
+ var step = Math.max(1, r * 0.05);
+ var samples = r === 0 ? 1 : Math.max(8, Math.floor(r * 0.6));
+ for (var s = 0; s < samples; s++) {
+ var ang = (s / samples) * Math.PI * 2;
+ var px = comX + Math.cos(ang) * r * ellipseBias - t.fullW / 2;
+ var py = comY + Math.sin(ang) * r - t.fullH / 2;
+ if (collides(t, px, py)) continue;
+ var dxx = (px + t.fullW / 2 - comX);
+ var dyy = (py + t.fullH / 2 - comY);
+ var cost = Math.hypot(dxx / ellipseBias, dyy) + rand() * step * 0.5;
+ if (cost < bestCost) { bestCost = cost; best = { x: px, y: py }; }
+ }
+ if (best && r > 0) break;
+ }
+ if (best) { t.x = best.x; t.y = best.y; stamp(t, best.x, best.y); placed.push(t); }
+ else { t.x = -99999; t.y = -99999; placed.push(t); }
+ }
+ return placed;
+ }
+ function mulberry32(a) {
+ return function () {
+ var t = a += 0x6D2B79F5;
+ t = Math.imul(t ^ (t >>> 15), t | 1);
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+ };
+ }
+
+ function renderCollageFromData() {
+ var items = (DATA.recent && DATA.recent.species) || [];
+ renderCollage(items);
+ }
+ function renderCollage(items) {
+ var collage = document.getElementById('collage');
+ collage.innerHTML = '';
+ if (!items.length) {
+ collage.innerHTML = 'no birds heard in this window.
';
+ return;
+ }
+ var W = collage.clientWidth, H = collage.clientHeight;
+ if (!W || !H) { setTimeout(function () { renderCollage(items); }, 80); return; }
+
+ var T = tuning(items.length);
+ var vpArea = W * H;
+ var budget = vpArea * T.packingBudgetFrac;
+ var minArea = vpArea * T.minTileAreaFrac;
+
+ var tiles = items.map(function (s) {
+ var slug = slugify(s.sci);
+ var mask = loadMask(slug);
+ if (!mask) return null;
+ var n = +s.n; if (!n || isNaN(n)) n = 1;
+ return { mask: mask, data: s, ar: aspect(s.sci), score: Math.pow(Math.max(1, n), T.countExp) };
+ }).filter(Boolean);
+
+ var sumScore = tiles.reduce(function (a, t) { return a + t.score; }, 0) || 1;
+ tiles.forEach(function (t) { t.area = Math.max(minArea, budget * t.score / sumScore); });
+ var sumA = tiles.reduce(function (a, t) { return a + t.area; }, 0);
+ if (sumA > budget) {
+ var fixedSum = tiles.filter(function (t) { return t.area <= minArea + 1e-9; })
+ .reduce(function (a, t) { return a + t.area; }, 0);
+ var flexSum = sumA - fixedSum;
+ var flexBudget = Math.max(0, budget - fixedSum);
+ var shrink = flexSum > 0 ? Math.min(1, flexBudget / flexSum) : 1;
+ tiles.forEach(function (t) { if (t.area > minArea + 1e-9) t.area *= shrink; });
+ }
+ tiles.forEach(function (t) {
+ t.fullW = Math.sqrt(t.area * t.ar);
+ t.fullH = t.fullW / t.ar;
+ });
+
+ var placed = maskPack(tiles, W, H, T.ellipseAspectBias);
+ function bounds(a) {
+ var L = Infinity, R = -Infinity, T2 = Infinity, B = -Infinity;
+ a.forEach(function (t) {
+ if (t.x < -1000) return;
+ if (t.x < L) L = t.x;
+ if (t.x + t.fullW > R) R = t.x + t.fullW;
+ if (t.y < T2) T2 = t.y;
+ if (t.y + t.fullH > B) B = t.y + t.fullH;
+ });
+ return { L: L, R: R, T: T2, B: B };
+ }
+ var b = bounds(placed);
+ for (var it = 0; it < 10; it++) {
+ var miss = placed.some(function (t) { return t.x < -1000; });
+ var over = b.L < 0 || b.T < 0 || b.R > W || b.B > H;
+ if (!miss && !over) break;
+ var scale = 0.93;
+ if (over) {
+ var clW = b.R - b.L, clH = b.B - b.T;
+ var sx = (W * 0.96) / Math.max(clW, W * 0.96);
+ var sy = (H * 0.94) / Math.max(clH, H * 0.94);
+ scale = Math.min(scale, sx, sy);
+ }
+ tiles.forEach(function (t) { t.fullW *= scale; t.fullH *= scale; });
+ placed = maskPack(tiles, W, H, T.ellipseAspectBias);
+ b = bounds(placed);
+ }
+ var dx = W / 2 - (b.L + b.R) / 2, dy = H / 2 - (b.T + b.B) / 2;
+ if (Math.abs(dx) > 1 || Math.abs(dy) > 1) {
+ placed.forEach(function (t) { if (t.x > -1000) { t.x += dx; t.y += dy; } });
+ }
+
+ placed.forEach(function (t) {
+ var s = t.data;
+ var img = api('/api/img?sci=' + encodeURIComponent(s.sci) +
+ (s.com ? '&com=' + encodeURIComponent(s.com) : '') +
+ '&v=' + IMG_VERSION);
+ var btn = document.createElement('button');
+ btn.className = 'gtile';
+ btn.type = 'button';
+ btn.setAttribute('data-sci', s.sci);
+ btn.setAttribute('aria-label', s.com || s.sci);
+ btn.title = (s.com || s.sci) + ' · ' + (+s.n || 0) + ' calls';
+ btn.style.left = t.x + 'px';
+ btn.style.top = t.y + 'px';
+ btn.style.width = t.fullW + 'px';
+ btn.style.height = t.fullH + 'px';
+ btn.innerHTML = 'no detections in this window
'; return; }
+ var now = Date.now();
+ var windowStart = currentHours >= 1000000 ? now - 90 * 24 * 3600000 : now - currentHours * 3600000;
+ var windowSpan = Math.max(1, now - windowStart);
+ sp.sort(function (a, b) { return (+b.n || 0) - (+a.n || 0); });
+ var W = tl.clientWidth || window.innerWidth;
+ var cap = Math.max(4, Math.floor(W / 28));
+ if (sp.length > cap) sp = sp.slice(0, cap);
+ var maxN = sp.reduce(function (m, s) { return Math.max(m, +s.n || 0); }, 1);
+ var html = '';
+ sp.forEach(function (s) {
+ var ts = Date.parse((s.last_seen || '').replace(' ', 'T'));
+ var leftPct = isNaN(ts) ? 50 : ((Math.max(windowStart, Math.min(now, ts)) - windowStart) / windowSpan) * 100;
+ var n = +s.n || 0;
+ var bottomPct = (n / maxN) * 50;
+ html += '
';
+ });
+ html += '
no species yet — atlas fills in as the Pi detects birds.
'; return; }
+ var sort = readLS('av:atlasSort', 'count');
+ if (sort === 'count') sp.sort(function (a, b) { return (+b.n || 0) - (+a.n || 0); });
+ else if (sort === 'recent') sp.sort(function (a, b) {
+ return Date.parse((b.last_seen || '').replace(' ', 'T')) - Date.parse((a.last_seen || '').replace(' ', 'T'));
+ });
+ else sp.sort(function (a, b) {
+ return Date.parse((a.first_seen || '').replace(' ', 'T')) - Date.parse((b.first_seen || '').replace(' ', 'T'));
+ });
+ list.innerHTML = sp.map(function (s) {
+ var img = api('/api/img?sci=' + encodeURIComponent(s.sci) +
+ (s.com ? '&com=' + encodeURIComponent(s.com) : '') +
+ '&v=' + IMG_VERSION);
+ return '' +
+ '' + (s.com || s.sci) + ' ' +
+ '' + (+s.n || 0) + ' ' +
+ ' ';
+ }).join('');
+ [].slice.call(list.querySelectorAll('.atlas-card')).forEach(function (b) {
+ b.addEventListener('click', function () { openDetail({ sci: b.dataset.sci }); });
+ });
+ }
+
+ // ---- Detail modal (basic — opens recording + spectrogram for a species) ----
+ function openDetail(s) {
+ var sci = s.sci || s;
+ // Lookup full record from lifelist if available
+ var rec = ((DATA.lifelist && DATA.lifelist.species) || []).find(function (x) { return x.sci === sci; }) || s;
+ var img = api('/api/img?sci=' + encodeURIComponent(sci) +
+ (rec.com ? '&com=' + encodeURIComponent(rec.com) : '') +
+ '&v=' + IMG_VERSION);
+ var rec_url = api('/api/recording?sci=' + encodeURIComponent(sci));
+ var spec_url = api('/api/spectrogram?sci=' + encodeURIComponent(sci));
+ var modal = document.getElementById('detail-modal');
+ if (!modal) {
+ modal = document.createElement('div');
+ modal.id = 'detail-modal';
+ modal.setAttribute('role', 'dialog');
+ document.body.appendChild(modal);
+ }
+ modal.innerHTML =
+ '
' +
+ '' +
+ '
× ' +
+ '
' +
+ '
' + (rec.com || sci) + ' ' +
+ '
' + sci + '
' +
+ '
' + (+rec.n || 0) + ' calls · last heard ' + (rec.last_seen || '—') + '
' +
+ '
' +
+ '
' +
+ '
apartment birds
+
+
+ apartment birds
+ Heard Recently
+
+
+
+
+
+
+
+ most heard
+ most recent
+ first seen
+
+
+
+
+
+
+ 1H
+ 12H
+ 24H
+ 7D
+ ALL
+
+
+
+ collage
+ stats
+ atlas
+
+
+
+
+
+
×
+
apartment birds
+
The birds outside my window
+
A tiny microphone listens for birds passing the window and identifies them with Cornell's BirdNET . Each species shows up as an illustration in the collage — sized by how much it's been heard.
+
explore the birds →
+
built with AvianVisitors
+
+
.png (perched) and -2.png
+(flight). The prompt template lives at avian/scripts/prompt.template.md
+— edit it to change the visual style.
+
+Usage:
+ # Generate the full BirdNET-Pi label set:
+ python3 pregen.py --labels /home/$USER/BirdNET-Pi/model/labels.txt
+
+ # Generate only species observed in eBird region US-CA:
+ python3 pregen.py --labels labels.txt --ebird-region US-CA --ebird-key YOUR_KEY
+
+ # Re-render a single species (useful when you tweak the prompt):
+ python3 pregen.py --species "Calypte anna|Anna's Hummingbird" --force
+
+ # Re-render everything (after a prompt change you actually want applied):
+ python3 pregen.py --labels labels.txt --force
+
+Set GEMINI_API_KEY in the environment or pass --gemini-key.
+"""
+from __future__ import annotations
+import argparse
+import base64
+import json
+import os
+import re
+import sys
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+from pathlib import Path
+
+GEMINI_URL = (
+ "https://generativelanguage.googleapis.com/v1beta/models/"
+ "gemini-2.5-flash-image:generateContent?key={key}"
+)
+POSES = {1: "perched", 2: "in flight with wings spread"}
+
+
+def slugify(sci: str) -> str:
+ return re.sub(r"[^a-z0-9]+", "-", sci.lower()).strip("-")
+
+
+def load_prompt(path: Path) -> str:
+ """Pull the prompt body from the markdown template — everything
+ after the `## Prompt` heading, stripped."""
+ text = path.read_text()
+ m = re.search(r"##\s*Prompt\s*\n(.+)$", text, flags=re.DOTALL)
+ return (m.group(1) if m else text).strip()
+
+
+def parse_labels(p: Path) -> list[tuple[str, str]]:
+ """BirdNET-Pi labels.txt format: `Sci name_Common Name` per line."""
+ out = []
+ for line in p.read_text().splitlines():
+ line = line.strip()
+ if not line or line.startswith("#"):
+ continue
+ # Split on first underscore (BirdNET format)
+ if "_" in line:
+ sci, com = line.split("_", 1)
+ elif "," in line:
+ sci, com = (s.strip() for s in line.split(",", 1))
+ else:
+ continue
+ sci = sci.strip()
+ com = com.strip()
+ if sci and com:
+ out.append((sci, com))
+ return out
+
+
+def ebird_filter(species: list[tuple[str, str]], region: str, key: str) -> list[tuple[str, str]]:
+ """Intersect a label set with the eBird observed-species list for a
+ region. Region codes look like US-CA (state) or US-CA-085 (county).
+ See https://documenter.getpostman.com/view/664302/S1ENwy59"""
+ url = f"https://api.ebird.org/v2/product/spplist/{region}"
+ req = urllib.request.Request(url, headers={"X-eBirdApiToken": key})
+ with urllib.request.urlopen(req, timeout=30) as r:
+ ebird_codes = set(json.loads(r.read()))
+ # eBird returns 6-letter species codes — we need sci names. Use the
+ # taxonomy endpoint to map.
+ tax_url = f"https://api.ebird.org/v2/ref/taxonomy/ebird?fmt=json"
+ req2 = urllib.request.Request(tax_url, headers={"X-eBirdApiToken": key})
+ with urllib.request.urlopen(req2, timeout=60) as r:
+ taxonomy = json.loads(r.read())
+ code_to_sci = {t["speciesCode"]: t["sciName"] for t in taxonomy}
+ allowed_sci = {code_to_sci[c] for c in ebird_codes if c in code_to_sci}
+ return [(s, c) for s, c in species if s in allowed_sci]
+
+
+def gen_one(api_key: str, prompt: str, sci: str, com: str, pose: int) -> bytes:
+ """Single Gemini call. Returns raw PNG bytes."""
+ body = prompt.replace("{sci_name}", sci).replace("{com_name}", com).replace(
+ "{pose}", POSES[pose]
+ )
+ payload = {
+ "contents": [{"parts": [{"text": body}]}],
+ "generationConfig": {"responseModalities": ["IMAGE"]},
+ }
+ req = urllib.request.Request(
+ GEMINI_URL.format(key=urllib.parse.quote(api_key)),
+ data=json.dumps(payload).encode(),
+ headers={"Content-Type": "application/json"},
+ method="POST",
+ )
+ with urllib.request.urlopen(req, timeout=120) as r:
+ resp = json.loads(r.read())
+ for cand in resp.get("candidates", []):
+ for part in cand.get("content", {}).get("parts", []):
+ inline = part.get("inlineData") or part.get("inline_data")
+ if inline and inline.get("data"):
+ return base64.b64decode(inline["data"])
+ raise RuntimeError(f"no image in response: {json.dumps(resp)[:300]}")
+
+
+def main() -> int:
+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+ src = ap.add_mutually_exclusive_group(required=True)
+ src.add_argument("--labels", type=Path, help="BirdNET-Pi labels.txt path")
+ src.add_argument("--species", action="append", default=[],
+ help="Manual species in format 'Sci name|Common Name' (repeatable)")
+ src.add_argument("--stdin", action="store_true", help="Read species from stdin (one per line, same format)")
+ ap.add_argument("--ebird-region", help="eBird region code (e.g. US-CA, US-CA-085) to filter labels")
+ ap.add_argument("--ebird-key", help="eBird API key (or set EBIRD_API_KEY)")
+ ap.add_argument("--gemini-key", help="Gemini API key (or set GEMINI_API_KEY)")
+ ap.add_argument("--out", type=Path, default=Path(__file__).resolve().parents[1] / "assets" / "illustrations",
+ help="Output directory (default: avian/assets/illustrations/)")
+ ap.add_argument("--prompt", type=Path, default=Path(__file__).resolve().parent / "prompt.template.md",
+ help="Prompt template path")
+ ap.add_argument("--poses", nargs="+", type=int, default=[1, 2],
+ help="Which poses to render (1=perched, 2=flight). Default: both.")
+ ap.add_argument("--force", action="store_true", help="Re-render even if file exists")
+ ap.add_argument("--sleep", type=float, default=1.0, help="Seconds between API calls (rate limit)")
+ ap.add_argument("--limit", type=int, default=0, help="Cap species count for testing")
+ args = ap.parse_args()
+
+ gemini_key = args.gemini_key or os.environ.get("GEMINI_API_KEY", "")
+ if not gemini_key:
+ print("error: GEMINI_API_KEY required (--gemini-key or env)", file=sys.stderr)
+ return 2
+
+ # Build species list
+ if args.labels:
+ species = parse_labels(args.labels)
+ elif args.stdin:
+ species = parse_labels_lines(sys.stdin.read().splitlines())
+ else:
+ species = []
+ for s in args.species:
+ if "|" in s:
+ sci, com = s.split("|", 1)
+ species.append((sci.strip(), com.strip()))
+ if not species:
+ print("error: no species resolved", file=sys.stderr)
+ return 2
+
+ if args.ebird_region:
+ ek = args.ebird_key or os.environ.get("EBIRD_API_KEY", "")
+ if not ek:
+ print("error: --ebird-region requires --ebird-key or EBIRD_API_KEY", file=sys.stderr)
+ return 2
+ print(f"[ebird] filtering {len(species)} species against region {args.ebird_region}…")
+ species = ebird_filter(species, args.ebird_region, ek)
+
+ if args.limit:
+ species = species[:args.limit]
+
+ prompt = load_prompt(args.prompt)
+ args.out.mkdir(parents=True, exist_ok=True)
+
+ total = len(species) * len(args.poses)
+ print(f"generating {total} illustrations into {args.out}/")
+
+ done = skipped = failed = 0
+ for sci, com in species:
+ slug = slugify(sci)
+ for pose in args.poses:
+ fname = f"{slug}.png" if pose == 1 else f"{slug}-{pose}.png"
+ path = args.out / fname
+ if path.exists() and not args.force:
+ skipped += 1
+ continue
+ try:
+ data = gen_one(gemini_key, prompt, sci, com, pose)
+ path.write_bytes(data)
+ done += 1
+ print(f" ✓ {fname} ({len(data)//1024} KB)")
+ except (urllib.error.HTTPError, urllib.error.URLError, RuntimeError) as e:
+ failed += 1
+ print(f" ✗ {fname}: {e}", file=sys.stderr)
+ time.sleep(args.sleep)
+
+ print(f"\ngenerated {done} · skipped {skipped} · failed {failed}")
+ return 0 if failed == 0 else 1
+
+
+def parse_labels_lines(lines: list[str]) -> list[tuple[str, str]]:
+ out = []
+ for line in lines:
+ line = line.strip()
+ if not line:
+ continue
+ if "|" in line:
+ sci, com = line.split("|", 1)
+ elif "_" in line:
+ sci, com = line.split("_", 1)
+ elif "," in line:
+ sci, com = line.split(",", 1)
+ else:
+ continue
+ out.append((sci.strip(), com.strip()))
+ return out
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/avian/scripts/prompt.template.md b/avian/scripts/prompt.template.md
new file mode 100644
index 0000000..6b04040
--- /dev/null
+++ b/avian/scripts/prompt.template.md
@@ -0,0 +1,43 @@
+# Bird illustration prompt
+
+This is the prompt sent to Gemini for every bird illustration. Edit it
+to change the style — the entire visual feel of the collage flows
+through this template.
+
+Two placeholders get replaced per request:
+
+- `{sci_name}` — the binomial Latin name, e.g. `Calypte anna`
+- `{com_name}` — the English common name, e.g. `Anna's Hummingbird`
+- `{pose}` — either `perched` (pose 1) or `in flight with wings spread` (pose 2)
+
+The default style below is **kachō-e** — Edo-period Japanese
+flower-and-bird woodblock prints, rendered in ink and watercolor on
+warm paper. Replace the body of the prompt with whatever feels right
+for your apartment.
+
+---
+
+## Prompt
+
+Generate a {pose} {com_name} ({sci_name}) in the style of an Edo-period
+Japanese kachō-e woodblock print. Confident sumi-e ink linework with
+soft watercolor washes. Earthy, restrained palette — burnt umber,
+ochre, indigo, vermillion, muted greens. Plumage details rendered with
+short directional brush strokes; eye, beak, and feet drawn with crisp
+ink. The bird should be the only subject — NO background, NO branch
+unless the pose requires it (a single sparse twig is fine for
+perched), NO border or frame, NO text or signature.
+
+Anatomy must be biologically accurate for the named species:
+
+- Exactly two wings. Two legs. One head. One beak. One tail.
+- Posture and feather pattern matching {com_name} field-guide
+ references — color, markings, and body proportions must match the
+ real bird.
+- For perched poses: one wing folded against the body, the other
+ tucked behind. For flight: both wings extended in a natural flapping
+ position.
+
+Render at high resolution on a clean transparent background. Output
+the illustration with no surrounding scene, no caption, no shadow
+beneath the bird.
diff --git a/docs/thumb.png b/docs/thumb.png
new file mode 100644
index 0000000..80b0b74
Binary files /dev/null and b/docs/thumb.png differ
-
-!! note: see 'Migrating' on how to migrate from mcguirepr89
+---
-## Introduction
-BirdNET-Pi is built on the [BirdNET framework](https://github.com/kahst/BirdNET-Analyzer) by [**@kahst**](https://github.com/kahst) 
using [pre-built TFLite binaries](https://github.com/PINTO0309/TensorflowLite-bin) by [**@PINTO0309**](https://github.com/PINTO0309) . It is able to recognize bird sounds from a USB microphone or sound card in realtime and share its data with the rest of the world.
+## BOM
-Check out birds from around the world
-- [BirdWeather](https://app.birdweather.com)