~vladh/fotografiska2

7dd5855aa644d083409e8dd05bf6833003d78f47 — Vlad-Stefan Harbuz 1 year, 10 months ago bdeb22d
add README and REUSE
6 files changed, 74 insertions(+), 0 deletions(-)

A .reuse/templates/compact.jinja2
A LICENSES/blessing.txt
A README.md
M go.mod
A go.sum.license
M main.go
A .reuse/templates/compact.jinja2 => .reuse/templates/compact.jinja2 +6 -0
@@ 0,0 1,6 @@
{% for copyright_line in copyright_lines %}
{{ copyright_line }}
{% endfor %}
{% for expression in spdx_expressions %}
SPDX-License-Identifier: {{ expression }}
{% endfor %}

A LICENSES/blessing.txt => LICENSES/blessing.txt +5 -0
@@ 0,0 1,5 @@
The author disclaims copyright to this source code. In place of a legal notice, here is a blessing:

May you do good and not evil.
May you find forgiveness for yourself and forgive others.
May you share freely, never taking more than you give.

A README.md => README.md +55 -0
@@ 0,0 1,55 @@
<!--
© 2021 Vlad-Stefan Harbuz <vlad@vladh.net>
SPDX-License-Identifier: blessing
-->

![pstr string functions](images/character_bouhan_camera_sm1.png)

# fotografiska

fotografiska organises your photos/videos into a certain directory structure
that is easy to browse with a regular file manager.

This is a greatly improved version of the
[original fotografiska](https://git.sr.ht/~vladh/fotografiska).

Your photos/videos will be organised into subfolders by year and month, and
their filename will start with the date they were taken and also include a
unique hash of the file.

If the file is larger than 10MB, the hash will only be computed using the first
10MB of the file.

Here's an example. Let's say your files look like this:

	DSCF4325.JPG (taken 2021/01/01 05:23:11 +01:00)
	DSCF1234.JPG (taken 2020/08/27 11:00:00 +01:00)

You can run a command such as the following:

	fotografiska -srcDir ~/Downloads/photos -dstDir ~/Pictures

Your files will then be organised as follows:

	2020/
		02/
			2020.08.27_11.00.00+0100_b46976ab6907346a_DSCF1234.JPG
	2021/
		01/
			2020.01.01-05.23.11+0100_66f4c6bbab77a615_DSCF4325.JPG

The creation date and time will be taken from the EXIF data. When no EXIF data is
available, such as with videos, the file's modification time will be used.

Caveats:

1. Please note that if your photo/video has no EXIF data, and you've e.g. made a
copy of the file so its modification time is not the time it was taken,
fotografiska cannot correctly organise your photos into correct dates and times.

2. Always make a backup of your photos/videos before using fotografiska. It's
been reasonably tested, but it's best to be safe.

## Credits

Icon by [irasutoya](https://www.irasutoya.com)

M go.mod => go.mod +3 -0
@@ 1,3 1,6 @@
// © 2022 Vlad-Stefan Harbuz <vlad@vladh.net>
// SPDX-License-Identifier: blessing

module vladh.net/fotografiska2

go 1.19

A go.sum.license => go.sum.license +2 -0
@@ 0,0 1,2 @@
© 2022 Vlad-Stefan Harbuz <vlad@vladh.net>
SPDX-License-Identifier: blessing

M main.go => main.go +3 -0
@@ 1,3 1,6 @@
// © 2022 Vlad-Stefan Harbuz <vlad@vladh.net>
// SPDX-License-Identifier: blessing

package main

import (