Skip to content
πŸ—‚ Organise your documents and media files like magic, leaving your folders spotless.
Branch: master
Clone or download
itsjavi refactoring v2 (#1)
* unify checksum + metadata files
* merge metadata in single file
* optimize dirWalk on ignored dirs
* timezone fix by reading GPS coords
* other refinements
Latest commit c568753 Nov 8, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
Gopkg.lock refactoring v2 (#1) Nov 7, 2018
Gopkg.toml refactoring v2 (#1) Nov 7, 2018 refactoring v2 (#1) Nov 7, 2018
app.go refactoring v2 (#1) Nov 7, 2018
constants.go refactoring v2 (#1) Nov 7, 2018
fs.go refactoring v2 (#1) Nov 7, 2018
main.go refactoring v2 (#1) Nov 7, 2018
metadata.go refactoring v2 (#1) Nov 7, 2018
takeout.go refactoring v2 (#1) Nov 7, 2018
utils.go refactoring v2 (#1) Nov 7, 2018


😊Command line tool that helps you classifying and organizing automagically your photos, videos, audios and documents ✨

  • Having thousands of pictures and videos lost in complex nested folder structures?
  • Don't you remember what camera or phone did you use to take that picture, or if it's even yours?
  • Are you not sure if you have duplicates of the same picture?
  • Do you have many screen shots mixed up with your regular photos?
  • Do you have problems finding files from an specific date?

No problemo! This tool will organize all that mess for you.


  • Restructures the content of a folder recursively (pictures, videos, audios, archives, contacts, documents, ...)
  • Extracts media file metadata (like EXIF, XMP) and saves it in a metadata folder
  • Organizes the media by year, camera / app and month
  • Detects screenshots (by path name)
  • Detects duplicates and stores them separately in a 'duplicates' folder
  • Renames all the files using the timestamp and the file MD5 hash



go install


happytimes [-limit n] [-ext "xxx|yyy|zzz"] [-dry-run] [-fix-dates] move|copy <src> [<dest>]

# example:

happytimes -limit 100 -ext "jpg|png|gif" -fix-dates -dry-run copy ~/Pictures ./happytimes-test
You can’t perform that action at this time.