Skip to content

The OSINT investigator's workbench. One case, one folder, every tool. Local-first: your media and your investigations never leave your machine.

JavaScript

Release: v0.2.8 — entities, graph and timeline (#58)

OsintMeThat48d3a1714edf
diff --git a/README.md b/README.md
index a3acae4..8894fa7 100644
--- a/README.md
+++ b/README.md
@@ -1,22 +1,60 @@
-# Azimut
+<p align="center">
+ <picture>
+ <source
+ media="(prefers-color-scheme: dark)"
+ srcset="https://raw.githubusercontent.com/OsintMeThat/azimut/main/docs/media/lockup-dark.svg"
+ >
+ <img
+ src="https://raw.githubusercontent.com/OsintMeThat/azimut/main/docs/media/lockup-light.svg"
+ alt="Azimut"
+ height="52"
+ >
+ </picture>
+</p>
+
+<p align="center"><b>The OSINT workspace that runs on your machine.</b></p>
+
+<p align="center">
+ <a href="https://pypi.org/project/azimut/"><img alt="PyPI" src="https://img.shields.io/pypi/v/azimut?color=e8a33d"></a>
+ <a href="https://pypi.org/project/azimut/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/azimut"></a>
+ <a href="https://github.com/OsintMeThat/azimut/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/OsintMeThat/azimut/actions/workflows/ci.yml/badge.svg"></a>
+ <a href="https://github.com/OsintMeThat/azimut/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-AGPL--3.0-4c6ef5"></a>
+ <img alt="Platforms" src="https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-6b7280">
+</p>
+
+![One case in Azimut, from the clip that arrives to the proof, the analysis surfaces and the published report](https://raw.githubusercontent.com/OsintMeThat/azimut/main/docs/media/demo.gif)
-Azimut is a local OSINT workspace for reviewing media, building geolocation
-proofs and keeping case notes together.
+## Install & run
-It is built for open-source investigators, journalists and researchers. Each
-case is a plain folder that can be reopened, archived or shared.
+```bash
+pipx install azimut # isolated app install; plain `pip install azimut` also works
+azimut # starts on http://127.0.0.1:8477 and opens a browser tab
+```
-*The name is the French word for azimuth, the compass bearing you sight along
-to fix a point on the map.*
+No Python? Every release attaches a self-contained binary for Windows, macOS
+(Apple Silicon) and Linux on the
+[Releases page](https://github.com/OsintMeThat/azimut/releases) — download, run,
+and it opens in your browser.
+
+Your cases and settings live under `~/Azimut`, outside the app: upgrading or
+removing Azimut leaves them alone. [Install in detail](#install-in-detail) covers
+the binaries' first-run warnings, building from source and the development loop.
+
+## What Azimut is
-## v0.2.7: Movable workspaces and finished exports
+A local OSINT workspace for reviewing media, building geolocation proofs and
+keeping case notes together. It is built for open-source investigators,
+journalists and researchers. Each case is a plain folder that can be reopened,
+archived or shared.
-![Azimut workflows from source review to proof and report](https://raw.githubusercontent.com/OsintMeThat/azimut/main/docs/media/demo.gif)
+*The name is the French word for azimuth, the compass bearing you sight along
+to fix a point on the map.*
| Tool | What it does |
|------|--------------|
| **Board** | The whole case as one sortable table: typed identity fields per entity, one filter bar whose values are all taken from the case, and shared Details. |
| **Graph** | The same case drawn. Lenses pick what a reading is about, nodes cluster, edges carry their verb, and a click opens what a node connects to without losing the picture you were reading. |
+| **Timeline** | The same case on a time axis. Dated statements and media stack in coloured tracks, the ruler reads in any zone or at a saved place, date quality is drawn instead of flattened, and the window can be handed to Board, Graph or the map. |
| **Media** | Import local files or download by URL (X, Telegram, TikTok, YouTube, Instagram and more via yt-dlp, with a gallery-dl fallback for image-only posts). Public media is fetched cookie-less; a login-walled post prompts once for a browser session or an exported `cookies.txt`. Each item gets a clean local file, metadata and a SHA-256. Multi-photo posts open a picker. |
| **Files** | Every saved artifact in one Finder-style view of your folders, not just media: select several, drag them into a folder, search across the lot. |
| **Reverse Search** | Prepare an image or a video frame for keyless reverse-image services. Nothing uploads on its own. |
@@ -34,6 +72,30 @@ extension, and cross-platform binaries with a bundled ffmpeg.
Every tool works one-shot (a scratch session, no setup) or inside a case, a
plain directory holding the whole investigation.
+## New in v0.2.8
+
+Entities, graph and timeline:
+
+- Read the whole case as a table, with one filter bar whose values and counts all
+ come from the case, and file a person, an account or a statement by hand.
+- Draw the same question in the Graph: lenses, clustered nodes, verbs on the
+ edges, sources folded onto the edge they stand for, and an undo for the drawing
+ that never writes to the case.
+- Put dated statements and media on a Timeline, in coloured tracks, on any zone's
+ clock, with daylight under the ruler at a saved place.
+- Create and edit dates on the axis itself, and measure two entries without
+ pretending a coarse date is an exact one.
+- Hand one period from Timeline to Board, Graph and a session-only map layer.
+ Fact time never mixes with the date something was filed.
+- Keep statement confidence and source reliability apart, with support and
+ contradiction stated as their own links.
+- Date a statement through a guided editor for a year, a day, a bounded range or
+ a zoned time range, with the raw syntax still accepted.
+- Existing cases upgrade to SQLite schema 17 when they open, and bundles exported
+ by v0.2.7 still import.
+
+## Cases on disk
+
Inside a case, Azimut owns only the `azimut/` directory. `README.txt` explains
the boundary; anything else at the case root is yours and travels with the case
bundle.
@@ -48,38 +110,15 @@ The Case Doctor checks case integrity, including the derived Timeline index. It
only changes a case after you choose a repair, and states what a database rebuild
cannot recover before it starts.
-New in v0.2.7:
-
-- Keep analyst-owned files beside Azimut's managed `azimut/` directory in every
- case. Existing cases and older bundles migrate automatically.
-- Move or adopt the complete workspace from Settings, including on an external
- drive. Each copied file is SHA-256-verified before the pointer switches, and a
- missing drive stops startup instead of creating an empty workspace.
-- Diagnose damaged cases without writing to them, then choose each Case Doctor
- repair explicitly.
-- Calculate local sun and moon conditions offline and review their daily paths
- on the map.
-- Export selected notes as server-rendered PDFs with local images, diagrams and
- bundled fonts for scripts used around the world.
-- Choose separate export folders for note PDFs, media copies and proof PNGs;
- external exports reserve a new name atomically instead of overwriting.
-- Save video frames under timecode-first names and preserve a Geo Report before
- handing a different proof to the composer.
+## Install in detail
-## Install & run
-
-```bash
-pipx install azimut # isolated app install; plain `pip install azimut` also works
-azimut # starts on http://127.0.0.1:8477 and opens a browser tab
-```
+Azimut runs in a normal browser tab (Firefox/Chrome); there is no separate
+window. Closing the terminal it prints its URL into stops the app.
Update with `pipx upgrade azimut`, remove with `pipx uninstall azimut`. Your
cases and settings live under `~/Azimut`; upgrades and uninstalling the app do
not remove them. Delete `~/Azimut` manually if you also want to remove the data.
-Azimut runs in a normal browser tab (Firefox/Chrome); there is no separate
-window. Closing the terminal it prints its URL into stops the app.
-
### Ready-to-run binary (no Python)
Each release attaches a self-contained binary per OS. Download it from the
@@ -114,7 +153,7 @@ put ffmpeg on your `PATH` for those features. Everything else works without it.
The bundled ffmpeg is redistributed under its own license; see
[ffmpeg.org/legal.html](https://ffmpeg.org/legal.html).
-From source:
+### From source
Requires Python 3.11+ and Node.js 20+ for the frontend build.
@@ -235,7 +274,7 @@ wheel + Windows/Linux/macOS binaries, attaches them to a GitHub release, and
publishes to PyPI. **Don't publish by hand.**
```bash
-git tag v0.2.7 && git push origin v0.2.7
+git tag v0.2.8 && git push origin v0.2.8
```
One-time setup: register the repo as a
diff --git a/docs/RELEASE_NOTES.md b/docs/RELEASE_NOTES.md
index 017ad81..4fa6127 100644
--- a/docs/RELEASE_NOTES.md
+++ b/docs/RELEASE_NOTES.md
@@ -1,4 +1,4 @@
-# Azimut v0.2.7
+# Azimut v0.2.8
## OSINT toolkit at a glance
@@ -10,207 +10,84 @@
offline.
- **Evidence:** organise media, places, proofs and notes in portable cases with
folders, relations, Markdown notebooks and PDF exports.
+- **Analysis:** read the same case as a table, as a drawing or on a time axis,
+ with statements, sources and confidence kept apart.
- **Publishing:** build annotated Geo Proofs and prepare evidence-linked Geo
Reports for X, Bluesky or Mastodon without posting automatically.
-## What changed in v0.2.7
-
-### Case folders that belong to the analyst
-
-- **A clear ownership boundary.** Azimut now keeps its managed files under the
- case's `azimut/` directory. Everything beside it belongs to the analyst and
- travels with the case bundle.
-- **Readable, predictable storage.** The database and editable metadata move
- into hidden internal directories, while visible files keep the names shown in
- the app. Existing cases and older bundles migrate automatically.
-- **Adopt an existing folder.** A folder created in the workspace can become a
- case in place without moving or reading the analyst's files.
-
-### A workspace that can move safely
-
-- **Move or adopt the workspace from Settings.** Azimut verifies every copied
- file with SHA-256 before switching through a pointer stored outside the
- workspace, and keeps the old copy until the analyst chooses to remove it.
-- **External drives work too.** Move or adopt the workspace on an external
- drive. If it is disconnected, Azimut reports the missing location instead of
- starting an empty workspace.
-- **No silent replacement for missing work.** If a configured workspace
- disappears, startup shows where it was expected instead of creating an empty
- replacement.
-- **One Azimut per workspace.** An operating-system lock and heartbeat prevent
- two instances from writing to the same workspace. A stale or unreliable lock
- can still be overridden explicitly.
-
-### Case Doctor
-
-- **Read-only diagnosis first.** Case Doctor checks the database, registered
- media and files placed manually in `media/` without changing the case.
-- **Explicit repairs.** Each applicable repair is offered separately, including
- restoring a missing manifest, removing or relinking missing media records and
- rebuilding a lost database with its unrecoverable data stated beforehand.
-
-### Coords & Sky
-
-- **Sun and moon calculations offline.** A coordinate and date now return rise,
- set, azimuth, altitude, civil and nautical twilights, moon phase and
- bright-limb angle in local time and UTC.
-- **Visual day review.** The tool adds an altitude chart and compass view, while
- Satellite can draw the bodies' daily paths, hour marks and a selected bearing
- on the map.
-- **Polar conditions are first-class results.** Polar day, polar night and days
- without a moonrise are reported as conditions rather than errors.
-
-### Export finished work
-
-- **Separate export destinations.** Notes, media and proofs can each use a
- remembered folder chosen from the new folder browser. The case's own
- `exports/` remains the default.
-- **Notebook PDF export.** Export the open note or a selected batch as one PDF
- per note without opening a print dialog. Local images, entity references,
- tables, lists, code and Mermaid diagrams are preserved.
-- **Portable text rendering.** Bundled fonts and text shaping cover CJK,
- Arabic, Indic and other living scripts consistently across Windows, Linux and
- macOS. Unsupported characters produce a named warning instead of disappearing.
-- **Media and proof copies.** A media item or saved proof PNG can be copied to
- its destination and revealed in the system file manager. Files outside the
- case are never overwritten; concurrent name collisions atomically receive a
- numbered suffix.
-- **Stable note filenames.** Notes with the same title keep distinct stable PDF
- names across batch and individual exports, including after long-title
- truncation.
-- **Portable Settings backup.** Settings, keys, templates and the signature can
- travel to another machine, while absolute export paths and live download
- sessions stay behind; the UI marks the backup as private.
-
-### Workflow and interface reliability
-
-- **Frames sort by timecode.** Saved video frames now begin with their timecode,
- use the media title and receive stable numbering when several frames fall
- within one second. Windows-reserved filenames are handled safely.
-- **Safe proof-to-report handoff.** Sending a different proof to Geo Report
- files the thread already on screen before starting the next one, while sending
- the same proof again keeps editing its existing thread.
-- **Settings are easier to scan.** General, Publishing, Imagery, Templates,
- Capture extension, Storage and System now have focused sections. Export
- folders and workspace controls live together under Storage.
-
-## Also in v0.2.6
-
-### Portable case bundles
-
-- **Export a complete case.** The Case switcher now exports a portable
- `.azimut.zip` snapshot containing the case database and its declared files.
- The bundle has a SHA-256 manifest, so import rejects incomplete or modified
- content rather than opening it as a plausible-looking case.
-- **Import without overwriting.** Choose a bundle from the Case switcher to
- inspect its name, size, temporary-space requirement and protection state,
- then import it as a new case. Existing cases remain untouched; imported
- entities, links and confirmation state stay intact.
-- **Optional password protection.** A password encrypts the complete bundle,
- including filenames. Passwords are not retained by Azimut and cannot be
- recovered. Thumbnails, deleted files and unfinished background jobs stay out
- of bundles.
-
-### Recoverable deletion
-
-- **Trash for case artifacts.** Deleting a note, media item, proof or related
- record now moves its registered files and recovery record to Trash. Restore
- returns the artifact and its surviving links; permanent deletion and Empty
- Trash remain explicit actions.
-- **One undo point for multi-select.** Files can delete a selection together,
- with one confirmation, one Trash entry and one restore action for the whole
- operation.
-- **Safer interrupted work.** Delete and restore actions record their progress
- before moving data, so opening a case resolves an interrupted action instead
- of leaving a half-deleted artifact behind.
-
-### Reliability
-
-- **Case-aware media refresh.** Thumbnail polling follows pending work after a
- bundle import and reloads previews when switching cases, even where relative
- file paths match.
-- **Preserved confirmed locations.** Metadata backfill does not replace a
- location relation the analyst has already confirmed.
-- **Predictable map opening.** A saved place without its own recorded zoom now
- keeps the map's normal starting zoom instead of unexpectedly changing it.
-
-### Media evidence and relations
-
-- **Automatic media enrichment.** Image imports read EXIF and a perceptual
- hash locally; video imports read container, stream and tag metadata. Details
- keeps the readable fields together, and media with stated coordinates can be
- filtered and opened on the map.
-- **GPS suggestions that respect analyst work.** Parsed coordinates propose a
- linked place for review. A confirmed location always wins over a later
- backfill.
-- **Shared relation vocabulary.** Details and saved-place cards can create,
- review, confirm or remove the same typed relations, with a consistent reading
- of each edge.
-
-### Support and continuity
-
-- **Settings backups keep presets.** Exporting and importing Settings now
- carries reusable proof and post presets with the workspace configuration.
-- **Report an issue from About.** The form opens a prepared GitHub issue with
- the version, operating system and recent warnings. Workspace paths and account
- details are scrubbed before it leaves the app.
-- **A working product tour.** The README walkthrough now renders on GitHub and
- PyPI instead of leaving an empty video element.
-
-## Also in v0.2.5
-
-Mostly additions, with two fixes.
-
-- **Diagrams in case notes.** A ```` ```mermaid ```` fence in a Notebook note
- renders as a diagram, in the preview and in the exported PDF, so a movement
- timeline or a chain of inference stays in the case instead of moving to an
- external drawing tool. The library loads the first time a note holds a
- diagram, never on open, and it draws offline.
-- **Sentinel-2 cloud ceiling.** Cloudy passes now render by default, and a
- slider sets the ceiling. The tiles, the date calendar and "most recent" all
- follow the same number. Previously a configuration instance could apply its
- own cloud filter, so a date the calendar offered came back as an empty tile
- and read as a coverage gap.
-- **New logo.** The mark is redrawn as a cartographic north arrow, split on the
- north-south axis, and stays legible at favicon size on both themes. The app
- icon, the favicon, the extension icons and the Windows `.exe` icon are all
- generated from one geometry definition.
-- **Windows thumbnail fix.** Several downloads finishing at once could raise a
- path error instead of retrying, because the thumbnail directory was resolved
- before it existed. It is created first now.
-
-## Also in v0.2.4
-
-- **Saved work on the map.** Places, captures and filed screenshots can be
- browsed by geography or case folder, searched in English or the local name,
- previewed and shown on the map. Proofs appear at their own coordinates or at
- the captures they use.
-- **Case organisation.** The sidebar adds search, type and status filters,
- multi-select filing and a details drawer. Files adds Small, Large and List
- views with sortable columns and complete folder browsing.
-- **Named work.** Inspect, Geo Proof and Geo Report name their documents in the
- header and keep that name when saved or renamed. Inspect's save dialog can
- name a batch and attach one note.
-- **Faster browsing.** Media and Files now query a SQLite browse index. Search,
- folder filters and Media category counts cover the complete case instead of
- only the first 200 items. Files requests thumbnail metadata only for paths it
- can display.
-- **Better pickers and proofs.** Inspect, Reverse Search, Geo Proof and Notebook
- pickers can search and browse folders. Geo Proof supports coloured panel
- frames, layer controls and pasted overlays stored with that proof.
-- **Capture extension.** A map point can be saved as a place, and any page can
- be saved as a bookmark. Map captures keep their source metadata and
- attribution.
-- **Case-switch fix.** Saved Satellite items and Media thumbnail state are
- cleared before a different case loads, so data from the previous case no
- longer remains until refresh.
-- **Release and security hardening.** Release builds use pinned, SHA-256-checked
- ffmpeg archives and extract only the expected tools. Images above 100 MP are
- rejected before decode. SQLite schema 4 adds the media browse index and
- upgrades existing cases automatically.
-
-The read-only GitHub release check still runs on startup by default. It can be
-disabled in Settings, and offline failures remain silent.
+## What changed in v0.2.8
+
+The case stops being only a pile of files. Everything it holds is a typed
+entity, and three surfaces now read the same case: a table, a drawing and a
+time axis.
+
+### Board
+
+- **A row per entity, whatever its type.** A person, an account or a statement
+ had no screen before.
+- **One filter bar:** a search, a **+ Filter** menu and a removable chip per
+ term. Every value offered comes from the case, with its count.
+- **Search+ names the field that matched** under the row, so a vehicle found by
+ its plate is not an unexplained result. Totals read against the whole case.
+- **New entity builds its form from the type registry** and flags an identifier
+ the case already holds, with the existing row one click away.
+- **Board and Graph share one filter and one family of saved views.** Timeline
+ keeps its own, because tracks and a clock are not something a table can draw.
+
+### Graph
+
+- **Lenses decide what the drawing is about.** Nodes cluster, and every edge
+ states its direction and its verb.
+- **Expand, Collapse and Hide are explicit acts**, with `Ctrl+Z` on the drawing
+ and no writes to the case.
+- **A question worked out in the Board is drawn here.** The filter travels
+ rather than the rows it matched.
+- **Sources fold onto the edge they stand for**, and derivation, support, source
+ and account counts sit on the node.
+
+### Timeline
+
+- **A windowed UTC axis**, read 200 entries at a time, with a density histogram
+ keeping the whole chronology visible underneath.
+- **Any zone's clock**, named rather than offered as an offset, plus daylight
+ under the ruler for a place the case has saved.
+- **Date quality is drawn, not flattened:** points, bars, reduced dates over the
+ period their precision covers, dashed edges for approximate ones.
+- **Tracks** come from editable presets or a Search+ question, with colours,
+ folds, reordering and grouping.
+- **Dates can be created and edited on the axis**, and two entries measured
+ without turning a coarse date into an exact one.
+- **Views keep a reading.** Live autosaves its window, clock and tracks; a
+ Snapshot freezes up to 5,000 rows and opens read-only.
+- **Undated work stays visible**, and the date a fact entered Azimut never
+ masquerades as the date of the fact.
+
+### One period, four surfaces
+
+- **A window travels.** Timeline hands its period to Board, Graph and a
+ session-only map layer, which state it with the way back and a Clear.
+- **Fact time never mixes with filing time.** The window narrows the page, the
+ totals and a saved view alike, and leaves the "when was this filed" filters
+ alone.
+
+### Statements, sources and confidence
+
+- **Relations, Mentions, Claims and lineage stay separate** in Details, under
+ one validated verb registry.
+- **How sure and how reliable are two controls that never merge**, with the
+ source's Admiralty grade stated beside the name it belongs to.
+- **Sources, Supports and Contradictions read from the right end**, and
+ statements about a row add up before they list.
+- **A guided editor dates a statement**, from a year to a bounded or zoned
+ range, choosing precision, certainty and timezone separately. The raw syntax
+ is still accepted.
+
+### Storage
+
+- **Cases upgrade to SQLite schema 17 when they open**, including the derived
+ time projection Case Doctor checks.
+- **A case bundle exported by v0.2.7 still imports** and lands on the current
+ schema.
## Install or upgrade
@@ -224,5 +101,5 @@ Intel Macs require macOS 14 or newer and the Python package:
The binaries are unsigned. Follow the operating system prompt described in the
README on first launch.
-Existing cases upgrade in place. Older case bundles remain importable, and no
-manual export or migration is required.
+Existing cases upgrade in place when they open. Older case bundles remain
+importable, and no manual export or migration is required.
diff --git a/docs/media/demo.gif b/docs/media/demo.gif
index 416e613..4b75ec1 100644
Binary files a/docs/media/demo.gif and b/docs/media/demo.gif differ
diff --git a/docs/media/lockup-dark.svg b/docs/media/lockup-dark.svg
new file mode 100644
index 0000000..08b4f42
--- /dev/null
+++ b/docs/media/lockup-dark.svg
@@ -0,0 +1,28 @@
+<!-- The README lockup for dark backgrounds: the mark, then AZIMUT drawn at the
+ same cap height. Same two flanks as frontend/src/components/Logo.svelte and
+ the same seven letter paths as Wordmark.svelte, with the theme's own inks
+ inlined because a file GitHub and PyPI fetch on their own has no CSS.
+ frontend/src/components/brandAssets.test.js holds all of them together. -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 606 115" width="606" height="115" role="img" aria-label="Azimut">
+ <title>Azimut</title>
+ <g transform="translate(-26.6 2.5) scale(4.5833)">
+ <path fill="#e3e3e3" d="M12 1.8 5.8 21.4 12 16.4Z" />
+ <path fill="#e8a33d" d="M12 1.8 18.2 21.4 12 16.4Z" />
+ </g>
+ <g
+ transform="translate(109.3 7.5)"
+ fill="none"
+ stroke="#e3e3e3"
+ stroke-width="15"
+ stroke-linecap="butt"
+ stroke-linejoin="miter"
+ >
+ <path d="M0 100 25 0h13.3l25 100" />
+ <path d="M13 69h37.3" />
+ <path transform="translate(96.3 0)" d="M0 7.5h58L0 92.5h58" />
+ <path transform="translate(193.3 0)" d="M0 0v100" />
+ <path transform="translate(232.3 0)" d="M0 100V0l38 58 38-58v100" />
+ <path transform="translate(347.3 0)" d="M0 0v69a31 31 0 0 0 62 0V0" />
+ <path transform="translate(430.3 0)" d="M0 7.5h58M29 7.5V100" />
+ </g>
+</svg>
diff --git a/docs/media/lockup-light.svg b/docs/media/lockup-light.svg
new file mode 100644
index 0000000..bf86d17
--- /dev/null
+++ b/docs/media/lockup-light.svg
@@ -0,0 +1,28 @@
+<!-- The README lockup for light backgrounds: the mark, then AZIMUT drawn at the
+ same cap height. Same two flanks as frontend/src/components/Logo.svelte and
+ the same seven letter paths as Wordmark.svelte, with the theme's own inks
+ inlined because a file GitHub and PyPI fetch on their own has no CSS.
+ frontend/src/components/brandAssets.test.js holds all of them together. -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 606 115" width="606" height="115" role="img" aria-label="Azimut">
+ <title>Azimut</title>
+ <g transform="translate(-26.6 2.5) scale(4.5833)">
+ <path fill="#23262b" d="M12 1.8 5.8 21.4 12 16.4Z" />
+ <path fill="#e8a33d" d="M12 1.8 18.2 21.4 12 16.4Z" />
+ </g>
+ <g
+ transform="translate(109.3 7.5)"
+ fill="none"
+ stroke="#23262b"
+ stroke-width="15"
+ stroke-linecap="butt"
+ stroke-linejoin="miter"
+ >
+ <path d="M0 100 25 0h13.3l25 100" />
+ <path d="M13 69h37.3" />
+ <path transform="translate(96.3 0)" d="M0 7.5h58L0 92.5h58" />
+ <path transform="translate(193.3 0)" d="M0 0v100" />
+ <path transform="translate(232.3 0)" d="M0 100V0l38 58 38-58v100" />
+ <path transform="translate(347.3 0)" d="M0 0v69a31 31 0 0 0 62 0V0" />
+ <path transform="translate(430.3 0)" d="M0 7.5h58M29 7.5V100" />
+ </g>
+</svg>
diff --git a/frontend/e2e/app.fixture.js b/frontend/e2e/app.fixture.js
index 234184b..2e52640 100644
--- a/frontend/e2e/app.fixture.js
+++ b/frontend/e2e/app.fixture.js
@@ -60,7 +60,7 @@ const settings = {
eco_max_zooms: {},
provider_status: {},
ingest_token: '',
- version: '0.2.7',
+ version: '0.2.8',
workspace_root: '/tmp/azimut-browser-fixture',
extension_version: '0.2.5', // tracks the extension, so it lags the app version
update_check_on_start: false,
diff --git a/frontend/src/components/Logo.svelte b/frontend/src/components/Logo.svelte
index 2095f9f..9d1012f 100644
--- a/frontend/src/components/Logo.svelte
+++ b/frontend/src/components/Logo.svelte
@@ -7,8 +7,9 @@
map north arrows have always used, which is why it carries the colour.
The west flank goes through --brand-ink so it stays legible on both
themes; the amber tracks --accent, which app.css pins across themes.
- The same two paths are in public/favicon.svg and are redrawn by
- packaging/icons/render_icons.py — move all three together. -->
+ The same two paths are in public/favicon.svg and docs/media/lockup-*.svg,
+ and are redrawn by packaging/icons/render_icons.py — move all of them
+ together; brandAssets.test.js fails if one drifts. -->
<svg width={size} height={size} viewBox="0 0 24 24" aria-label="Azimut logo">
<path fill="var(--brand-ink, #e3e3e3)" d="M12 1.8 5.8 21.4 12 16.4Z" />
<path fill="#e8a33d" d="M12 1.8 18.2 21.4 12 16.4Z" />
diff --git a/frontend/src/components/Wordmark.svelte b/frontend/src/components/Wordmark.svelte
index c2cd422..fd0c5bb 100644
--- a/frontend/src/components/Wordmark.svelte
+++ b/frontend/src/components/Wordmark.svelte
@@ -7,7 +7,10 @@
Cap height 100, stroke 15, butt caps and mitre joins. The A's apex is cut
flat: a mitred point there goes thin and sharp next to the squared-off M,
U and T. Letter positions carry pair kerning, not uniform spacing — evenly
- spaced, the T's centred stem leaves a hole and it reads "AZIMU T". -->
+ spaced, the T's centred stem leaves a hole and it reads "AZIMU T".
+ The same seven paths sit in docs/media/lockup-*.svg for the README, where
+ there is no CSS to read the ink from; brandAssets.test.js holds them
+ together. -->
<svg {height} viewBox="-7.5 -7.5 503.3 115" aria-label="Azimut">
<g
fill="none"
diff --git a/frontend/src/components/brandAssets.test.js b/frontend/src/components/brandAssets.test.js
index 57e62a1..31bf59f 100644
--- a/frontend/src/components/brandAssets.test.js
+++ b/frontend/src/components/brandAssets.test.js
@@ -2,14 +2,20 @@ import { readFileSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
import { describe, expect, it } from 'vitest';
-// The mark ships twice: as a component for the app, and as a standalone
-// favicon for surfaces with no CSS context. Nothing links the two files, so
-// this asserts they still draw the same arrow.
+// The mark ships four times: as a component for the app, as a standalone
+// favicon for surfaces with no CSS context, and as the two README lockups
+// GitHub and PyPI fetch on their own. Nothing links the files, so this asserts
+// they still draw the same arrow and the same six letters.
const read = (rel) => readFileSync(fileURLToPath(new URL(rel, import.meta.url)), 'utf8');
const WEST = 'd="M12 1.8 5.8 21.4 12 16.4Z"';
const EAST = 'd="M12 1.8 18.2 21.4 12 16.4Z"';
+const LOCKUPS = ['../../../docs/media/lockup-light.svg', '../../../docs/media/lockup-dark.svg'];
+
+/** The `d` of every path in a file, in document order. */
+const paths = (svg) => [...svg.matchAll(/\bd="([^"]+)"/g)].map((m) => m[1]);
+
describe('brand assets', () => {
it('the component and the favicon draw the same two flanks', () => {
const logo = read('./Logo.svelte');
@@ -25,4 +31,25 @@ describe('brand assets', () => {
expect(favicon).toContain('fill="#14171b"');
expect(favicon).toContain('#e8a33d');
});
+
+ it('both README lockups draw the mark and the wordmark of the app', () => {
+ const letters = paths(read('./Wordmark.svelte'));
+ expect(letters).toHaveLength(7); // six letters, the A wearing its crossbar
+ for (const rel of LOCKUPS) {
+ const lockup = read(rel);
+ for (const flank of [WEST, EAST]) expect(lockup).toContain(flank);
+ // The mark's two flanks come first, then the letters, unchanged.
+ expect(paths(lockup).slice(2)).toEqual(letters);
+ }
+ });
+
+ it('each lockup carries the ink of the background it is served on', () => {
+ // A file fetched outside the app has no theme to read, so the pair exists
+ // precisely to spell the ink out: the light one dark, the dark one light.
+ expect(read(LOCKUPS[0])).toContain('#23262b');
+ expect(read(LOCKUPS[0])).not.toContain('#e3e3e3');
+ expect(read(LOCKUPS[1])).toContain('#e3e3e3');
+ expect(read(LOCKUPS[1])).not.toContain('#23262b');
+ for (const rel of LOCKUPS) expect(read(rel)).toContain('#e8a33d');
+ });
});
diff --git a/src/azimut/__init__.py b/src/azimut/__init__.py
index bf86454..108d409 100644
--- a/src/azimut/__init__.py
+++ b/src/azimut/__init__.py
@@ -13,7 +13,7 @@ from PIL import Image as _Image
# The capture extension is versioned separately, on purpose — it carries the
# release that last changed it (tests/test_updates.py). Don't move the two
# together.
-__version__ = "0.2.7"
+__version__ = "0.2.8"
# Cap the pixels Pillow will decode from a file, process-wide. A tiny,
# highly-compressed image can otherwise expand to gigabytes in memory and take