{
 "blyg": "0.4",
 "id": "6xr8s57d5r3yhr1szrz3pbrk5g",
 "kind": "thread",
 "origin": "https://notionparallax.co.uk/",
 "page": "https://notionparallax.co.uk/2026/dive-inat",
 "author": {
  "name": "Ben Doherty",
  "url": "https://notionparallax.co.uk/"
 },
 "created": "2026-11-19T01:00:00Z",
 "updated": "2026-11-19T01:00:00Z",
 "version": 1,
 "content_md": "# Dive iNat: from dive video to iNaturalist\n\n\n> Tl;dr: I made a workflow for getting stills and gifs out of YouTube videos and into iNaturalist. You can play with it now. It needs a better name.\n\nI film a lot of my dives; weirdly it turns out that a lot of people find my breathing relaxing. There is a lot of wildlife in those videos, but to get it onto [iNaturalist](https://www.inaturalist.org) takes a surprisingly long time. An observation needs a photo, a time and a place, and getting those out of a video by hand (scrub to the moment, screenshot, crop, work out what time it was, guess the depth) is slow enough that I only captured the most exciting animals.\n\nI've (well Claude did the work) made a small tool to do the tedious parts. It's called [Dive iNat](https://notionparallax.github.io/inat-workflow/), and it's free to use in Chrome.\n\n## What it does\n\n![The main screen, with the video above the depth profile from the dive log](https://raw.githubusercontent.com/notionparallax/inat-workflow/main/store/screenshot-main-1280x800.png)\n\nYou give it a YouTube link to your dive video, and the log of the same dive exported from [Subsurface](https://subsurface-divelog.org/). You line the two up by pausing on the frame where you go under and the frame where you surface, and from then on the tool knows what the dive computer was saying throughout the video.\n\nWhen something worth recording swims past, you press `M`. The tool grabs a burst of full-resolution frames around that moment, ranks them by sharpness, and lets you pick up to four. You can click on the animal to note where it is in the frame, add a crop of it, or make a short GIF, which helps with things that are easier to identify by how they move. Press `C`, then `Enter`, and it's on iNaturalist.\n\nEach observation gets the time, worked out from the dive log; the depth and water temperature, as iNaturalist observation fields; the GPS position recorded at the start of the dive; and a link back to the exact second of the video. That last part means anyone looking at the observation can go and watch the animal moving, which can help pin down an ID.\n\nThe tool doesn't try to identify anything. iNaturalist already has a large community of people who are good at that, and I'm not. In fact, it tries to do as little as possible.\n\n## An example: Gordon's Bay, 15 November\n\nThe first proper test was a shore dive at Gordon's Bay on 15 November: 112 minutes, a maximum depth of 13.7 m, and 20 °C water the whole way. From the video I made 49 observations. A few days later, 34 of them are research grade, they cover 21 different taxa, and 16 people other than me have added identifications. The list is mostly what you would expect at Gordon's (eastern blue groper, white-ears, red morwong, a run of common stingarees near the end), plus a few I was pleased to have, such as a [crested hornshark egg case](https://www.inaturalist.org/observations/415063712).\n\nOnce the identifications have settled, the tool can turn them into YouTube chapters, so the video itself becomes an index of what was seen. For this dive the start of that list looks like this:\n\n> 7:04 Eastern Blue Groper (Achoerodus viridis) <https://inaturalist.org/observations/415038559>\n>\n> 11:17 Scorpionfishes and Allies (Scorpaenoidei) <https://inaturalist.org/observations/415049666>\n>\n> 12:50 Eastern Blue Groper (Achoerodus viridis) <https://inaturalist.org/observations/415052145>\n\n## What it doesn't do (yet)\n\n- The location is the dive's entry point, as recorded by the dive computer (if you're fancy), and every observation from the dive gets the same one. On a shore dive at Gordon's that is close enough, but on a long swim or a drift dive the animal could be hundreds of metres away. The notes on each observation say this plainly, and the tool marks the location as accurate to 150 m by default.\n\n    When I was [mapping Gordon's Bay](https://github.com/notionparallax/dive-map) for my DM, I towed a phone in a waterproof box on a float and matched photo timestamps to the track it recorded. The same trick would work here: the tool already knows the time of every frame, so with a track it could place each observation along the route rather than at the entry point. It won't be exact, because the float drifts at the end of its line and the error grows with depth, but it would make the locations much more useful, particularly for long shore dives and drift dives.\n\n- The timing is only as good as the sync. My computer records a sample every 10 seconds, so the depth is interpolated between samples, and lining up the video depends on you choosing the right frames.\n\n- It only works in desktop Chrome and other Chromium browsers, because of the extension (more on that below). You log in by pasting an iNaturalist API token, which lasts 24 hours; if people find the tool useful, I'd like to replace that with a proper login. Captured frames live in memory, so if you reload the page in the middle of an observation, you lose it, and that needs fixing too. Further off, I'd like a mode for video without a dive log, for snorkellers and anyone else filming outside.\n\n## No server\n\nI have a strange aversion to servers. It's slowly improving, but they add so much technical and legal complexity. The whole thing is a static website, so there is no server behind it, no account to create, and no analytics. The dive log is read, the observations are made, and the package is put together, all in your browser. Then the browser sends them straight to iNaturalist. Your iNaturalist token is stored in your local storage and sent only to iNaturalist. I couldn't collect your data if I wanted to.\n\nThe one awkward part of not having a server is that web pages aren't allowed to read pictures out of an embedded YouTube player. A small Chrome extension, the [Dive iNat frame grabber](https://chromewebstore.google.com/detail/dive-inat-frame-grabber/nlecoipnfjnedajcjdlagpolhaehjcdl), does that one job. It runs only inside the player on the Dive iNat page, copies the frame you're looking at, and hands it to the page. It has no network access and stores nothing. It doesn't download videos either; it can only see what you are already watching. The [privacy page](https://notionparallax.github.io/inat-workflow/privacy.html) says the same thing at more length, and all of the code is [on GitHub](https://github.com/notionparallax/inat-workflow) for anyone who would like to check.\n\n## Other people's videos\n\nThe tool works with any YouTube dive video, but please only use your videos or videos whose owner has said yes. The frames go up under your iNaturalist account's photo licence, so you are agreeing to that licence on behalf of the owner too. The tool asks you to confirm this for each video, and writes the credit into the notes.\n\n## Trying it\n\nIf you have a dive video on YouTube and a Subsurface log for the same dive, it should take a few minutes to get going:\n\n1. Install the [frame grabber extension](https://chromewebstore.google.com/detail/dive-inat-frame-grabber/nlecoipnfjnedajcjdlagpolhaehjcdl).\n2. Open [Dive iNat](https://notionparallax.github.io/inat-workflow/) and follow the introduction.\n3. Keep the [keyboard shortcuts](https://notionparallax.github.io/inat-workflow/shortcuts.html) to hand; there's a printable version.\n\nUploads start in dry-run mode, which shows what would be sent without sending it, so you can try it on a dive without filling iNaturalist with test observations. It's early, and there will be things that don't work. If you find one, or have a video that it struggles with, [open an issue](https://github.com/notionparallax/inat-workflow/issues) or tell me about it.\n\n## Naming is hard\n\nThis doesn't really have a name yet, but it needs one. If you can think of something interesting, let me know. The same goes for [the dive planner tool](https://notionparallax.co.uk/2026/dive_planner) too.\n",
 "content_html": "<h1>Dive iNat: from dive video to iNaturalist</h1>\n<blockquote>\n  <p>Tl;dr: I made a workflow for getting stills and gifs out of YouTube videos and into iNaturalist. You can play with it now. It needs a better name.</p>\n</blockquote>\n\n<p>I film a lot of my dives; weirdly it turns out that a lot of people find my breathing relaxing. There is a lot of wildlife in those videos, but to get it onto <a href=\"https://www.inaturalist.org\">iNaturalist</a> takes a surprisingly long time. An observation needs a photo, a time and a place, and getting those out of a video by hand (scrub to the moment, screenshot, crop, work out what time it was, guess the depth) is slow enough that I only captured the most exciting animals.</p>\n\n<p>I’ve (well Claude did the work) made a small tool to do the tedious parts. It’s called <a href=\"https://notionparallax.github.io/inat-workflow/\">Dive iNat</a>, and it’s free to use in Chrome.</p>\n\n<h2 id=\"what-it-does\">What it does</h2>\n\n<p><img src=\"https://raw.githubusercontent.com/notionparallax/inat-workflow/main/store/screenshot-main-1280x800.png\" alt=\"The main screen, with the video above the depth profile from the dive log\" /></p>\n\n<p>You give it a YouTube link to your dive video, and the log of the same dive exported from <a href=\"https://subsurface-divelog.org/\">Subsurface</a>. You line the two up by pausing on the frame where you go under and the frame where you surface, and from then on the tool knows what the dive computer was saying throughout the video.</p>\n\n<p>When something worth recording swims past, you press <code class=\"language-plaintext highlighter-rouge\">M</code>. The tool grabs a burst of full-resolution frames around that moment, ranks them by sharpness, and lets you pick up to four. You can click on the animal to note where it is in the frame, add a crop of it, or make a short GIF, which helps with things that are easier to identify by how they move. Press <code class=\"language-plaintext highlighter-rouge\">C</code>, then <code class=\"language-plaintext highlighter-rouge\">Enter</code>, and it’s on iNaturalist.</p>\n\n<p>Each observation gets the time, worked out from the dive log; the depth and water temperature, as iNaturalist observation fields; the GPS position recorded at the start of the dive; and a link back to the exact second of the video. That last part means anyone looking at the observation can go and watch the animal moving, which can help pin down an ID.</p>\n\n<p>The tool doesn’t try to identify anything. iNaturalist already has a large community of people who are good at that, and I’m not. In fact, it tries to do as little as possible.</p>\n\n<h2 id=\"an-example-gordons-bay-15-november\">An example: Gordon’s Bay, 15 November</h2>\n\n<p>The first proper test was a shore dive at Gordon’s Bay on 15 November: 112 minutes, a maximum depth of 13.7 m, and 20 °C water the whole way. From the video I made 49 observations. A few days later, 34 of them are research grade, they cover 21 different taxa, and 16 people other than me have added identifications. The list is mostly what you would expect at Gordon’s (eastern blue groper, white-ears, red morwong, a run of common stingarees near the end), plus a few I was pleased to have, such as a <a href=\"https://www.inaturalist.org/observations/415063712\">crested hornshark egg case</a>.</p>\n\n<p>Once the identifications have settled, the tool can turn them into YouTube chapters, so the video itself becomes an index of what was seen. For this dive the start of that list looks like this:</p>\n\n<blockquote>\n  <p>7:04 Eastern Blue Groper (Achoerodus viridis) <a href=\"https://inaturalist.org/observations/415038559\">https://inaturalist.org/observations/415038559</a></p>\n\n  <p>11:17 Scorpionfishes and Allies (Scorpaenoidei) <a href=\"https://inaturalist.org/observations/415049666\">https://inaturalist.org/observations/415049666</a></p>\n\n  <p>12:50 Eastern Blue Groper (Achoerodus viridis) <a href=\"https://inaturalist.org/observations/415052145\">https://inaturalist.org/observations/415052145</a></p>\n</blockquote>\n\n<h2 id=\"what-it-doesnt-do-yet\">What it doesn’t do (yet)</h2>\n\n<ul>\n  <li>\n    <p>The location is the dive’s entry point, as recorded by the dive computer (if you’re fancy), and every observation from the dive gets the same one. On a shore dive at Gordon’s that is close enough, but on a long swim or a drift dive the animal could be hundreds of metres away. The notes on each observation say this plainly, and the tool marks the location as accurate to 150 m by default.</p>\n\n    <p>When I was <a href=\"https://github.com/notionparallax/dive-map\">mapping Gordon’s Bay</a> for my DM, I towed a phone in a waterproof box on a float and matched photo timestamps to the track it recorded. The same trick would work here: the tool already knows the time of every frame, so with a track it could place each observation along the route rather than at the entry point. It won’t be exact, because the float drifts at the end of its line and the error grows with depth, but it would make the locations much more useful, particularly for long shore dives and drift dives.</p>\n  </li>\n  <li>\n    <p>The timing is only as good as the sync. My computer records a sample every 10 seconds, so the depth is interpolated between samples, and lining up the video depends on you choosing the right frames.</p>\n  </li>\n  <li>\n    <p>It only works in desktop Chrome and other Chromium browsers, because of the extension (more on that below). You log in by pasting an iNaturalist API token, which lasts 24 hours; if people find the tool useful, I’d like to replace that with a proper login. Captured frames live in memory, so if you reload the page in the middle of an observation, you lose it, and that needs fixing too. Further off, I’d like a mode for video without a dive log, for snorkellers and anyone else filming outside.</p>\n  </li>\n</ul>\n\n<h2 id=\"no-server\">No server</h2>\n\n<p>I have a strange aversion to servers. It’s slowly improving, but they add so much technical and legal complexity. The whole thing is a static website, so there is no server behind it, no account to create, and no analytics. The dive log is read, the observations are made, and the package is put together, all in your browser. Then the browser sends them straight to iNaturalist. Your iNaturalist token is stored in your local storage and sent only to iNaturalist. I couldn’t collect your data if I wanted to.</p>\n\n<p>The one awkward part of not having a server is that web pages aren’t allowed to read pictures out of an embedded YouTube player. A small Chrome extension, the <a href=\"https://chromewebstore.google.com/detail/dive-inat-frame-grabber/nlecoipnfjnedajcjdlagpolhaehjcdl\">Dive iNat frame grabber</a>, does that one job. It runs only inside the player on the Dive iNat page, copies the frame you’re looking at, and hands it to the page. It has no network access and stores nothing. It doesn’t download videos either; it can only see what you are already watching. The <a href=\"https://notionparallax.github.io/inat-workflow/privacy.html\">privacy page</a> says the same thing at more length, and all of the code is <a href=\"https://github.com/notionparallax/inat-workflow\">on GitHub</a> for anyone who would like to check.</p>\n\n<h2 id=\"other-peoples-videos\">Other people’s videos</h2>\n\n<p>The tool works with any YouTube dive video, but please only use your videos or videos whose owner has said yes. The frames go up under your iNaturalist account’s photo licence, so you are agreeing to that licence on behalf of the owner too. The tool asks you to confirm this for each video, and writes the credit into the notes.</p>\n\n<h2 id=\"trying-it\">Trying it</h2>\n\n<p>If you have a dive video on YouTube and a Subsurface log for the same dive, it should take a few minutes to get going:</p>\n\n<ol>\n  <li>Install the <a href=\"https://chromewebstore.google.com/detail/dive-inat-frame-grabber/nlecoipnfjnedajcjdlagpolhaehjcdl\">frame grabber extension</a>.</li>\n  <li>Open <a href=\"https://notionparallax.github.io/inat-workflow/\">Dive iNat</a> and follow the introduction.</li>\n  <li>Keep the <a href=\"https://notionparallax.github.io/inat-workflow/shortcuts.html\">keyboard shortcuts</a> to hand; there’s a printable version.</li>\n</ol>\n\n<p>Uploads start in dry-run mode, which shows what would be sent without sending it, so you can try it on a dive without filling iNaturalist with test observations. It’s early, and there will be things that don’t work. If you find one, or have a video that it struggles with, <a href=\"https://github.com/notionparallax/inat-workflow/issues\">open an issue</a> or tell me about it.</p>\n\n<h2 id=\"naming-is-hard\">Naming is hard</h2>\n\n<p>This doesn’t really have a name yet, but it needs one. If you can think of something interesting, let me know. The same goes for <a href=\"https://notionparallax.co.uk/2026/dive_planner\">the dive planner tool</a> too.</p>\n",
 "content_hash": "sha256:813616f4c89dfbe774794a85ce1a947bb863dc9b13bf377ec10665de272ee9a4",
 "media": [],
 "changelog": [
  {
   "version": 1,
   "at": "2026-11-19T01:00:00Z",
   "note": null
  }
 ],
 "transclusions": []
}