Screenshot Session Grouper
Group screenshots with explicit timestamp timezones and export collision-safe copies with SHA-256 manifests.
The problem it solves
Screenshot Session Grouper [](https://github.com/loganpendragonmultiverse/screenshot-session-grouper/actions/workflows/ci.yml)
Who Screenshot Session Grouper is for
- Players who want practical, local tools for libraries, saves, settings, or planning.
- Users working with screenshots, gaming, sessions who want the documented v1.1.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Group screenshots with explicit timestamp timezones and export collision-safe copies with SHA-256 manifests.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.1.0
Capabilities below come from the current project README and release documentation.
[](https://github.com/loganpendragonmultiverse/screenshot-session-grouper/actions/workflows/ci.yml)
Screenshot Session Grouper organizes image timestamps into likely game sessions. It produces a reviewable Markdown or JSON manifest and can optionally copy screenshots into new session folders without moving or deleting the originals.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
Quick start
The shortest documented path into the current release.
python -m pip install .
screenshot-sessions ~/Pictures/Game --gap-minutes 90 --output sessions.md
screenshot-sessions ~/Pictures/Game --timezone-offset=-04:00 --copy-to ~/Pictures/Game-Sessions --collision-mode sequenceRecognizable YYYY-MM-DD_HH-MM-SS filename timestamps take priority; other images use filesystem modification times. Use --timezone-offset to state the timezone encoded by filenames. A new session begins after the configured gap. Copy export stages a new destination, writes a SHA-256 copy manifest, and refuses existing, nested, or temporary targets. Duplicate basenames fail by default; --collision-mode sequence adds a stable numeric prefix.
Session boundaries are estimates. Edited timestamps, cloud downloads, copied files, and inconsistent clocks can produce misleading groups. The tool does not inspect image content or game metadata. Requires Python 3.10 or newer.
Part of the Logan Pendragon Forge open-source collection. Licensed under the [MIT License](LICENSE).
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
The current v1.1.0 release is bounded by the behavior documented in its README and changelog. It does not claim unsupported platforms, automatic interpretation, or results beyond the evidence it produces.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
No privacy behavior beyond the current repository documentation is claimed. Review the source, security policy, and input/output behavior before using sensitive material.
License and release
Screenshot Session Grouper is published under MIT. The current cataloged release is v1.1.0, published 2026-07-27.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Screenshot Session Grouper v1.1.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical local repository. Fingerprint: 8239326ee32588bb.