{"id":26253966,"url":"https://github.com/2mal3/iris","last_synced_at":"2025-03-13T18:18:48.626Z","repository":{"id":231915918,"uuid":"783012110","full_name":"2mal3/iris","owner":"2mal3","description":"A streamlined CLI application designed to efficiently rename and organize your pictures and videos by date.","archived":false,"fork":false,"pushed_at":"2025-01-03T13:09:03.000Z","size":46,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-03T14:26:31.807Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/2mal3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-06T17:34:29.000Z","updated_at":"2025-01-03T13:09:07.000Z","dependencies_parsed_at":"2024-08-17T10:43:51.992Z","dependency_job_id":"5a40e283-5ee9-4c26-b9ae-c3c43ed7dc38","html_url":"https://github.com/2mal3/iris","commit_stats":null,"previous_names":["2mal3/iris"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2mal3%2Firis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2mal3%2Firis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2mal3%2Firis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2mal3%2Firis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2mal3","download_url":"https://codeload.github.com/2mal3/iris/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243456560,"owners_count":20293905,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-13T18:18:48.230Z","updated_at":"2025-03-13T18:18:48.616Z","avatar_url":"https://github.com/2mal3.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# iris\n\nA streamlined CLI application designed to efficiently rename and organize your pictures and videos by date, making it perfect for locally merging, sorting and backing up your media from multiple sources.\n\n### Features\n\n- consistent renaming and sorting of files based on the time of recording, optimized for viewing in the file browser\n- reliable extraction of the recording time from the file metadata or from the filename if data is missing\n- automatic handling of duplicate images\n- high stability and security through sophisticated error handling\n\n\u003e Although I consider the program to be sufficiently safe, it is still relatively young and has potential bugs. Please consider this before entrusting it with your images.\n\n## Naming and Sorting\n\nIris renames each file (if a recording date was found) according to the following scheme: `year-month-day_hour-minute-second.extension`. The file is then moved to a subfolder named after the year and quarter in the `year-quarter` format.\nHowever, no normal quatals are used to better accommodate typical vacation periods. Instead, all quatals are moved back by two months. For example, February 2024 will still fall into quarter `2023-4` and December 2024 already into quarter `2025-1`.\n\n| Original Month and Year | Folder Name |\n| ----------------------- | ----------- |\n| January 2023            | 2022-4      |\n| February 2023           | 2022-4      |\n| March 2023              | 2023-1      |\n| April 2023              | 2023-1      |\n| May 2023                | 2023-1      |\n| June 2023               | 2023-2      |\n| July 2023               | 2023-2      |\n| August 2023             | 2023-2      |\n| September 2023          | 2023-3      |\n| October 2023            | 2023-3      |\n| November 2023           | 2023-3      |\n| December 2023           | 2023-4      |\n\n## Usage\n\n1. download the appropriate file for your architecture from the releases page\n2. create a `config.yaml` file in the same folder as the executable.\n3. configure the script to your needs using the sample config\n4. run the executable in a terminal\n\n### Example Config\n\n```yaml\ninput_paths:\n  -  \"/your/input/path\"\noutput_path: \"/your/output/path\"\nmove_files: true\nremove_duplicates: false\n\n```\n\n## License\n\n[GPL-3.0](/LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2mal3%2Firis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2mal3%2Firis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2mal3%2Firis/lists"}