picsort

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 23 Open GitHub ↗

Organize your photos by date in one click 👏

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# picsort 📸
![](https://travis-ci.org/mateuszjanusz/picsort.svg?branch=master)
[![](https://img.shields.io/npm/v/picsort.svg)]()
[![](https://img.shields.io/npm/dt/picsort.svg)]()

Organize your photos into folders by date through the command line.

## Demo
![](https://github.com/mateuszjanusz/picsort/blob/master/picsort_demo.gif)

It uses [node-exif](https://github.com/gomfunkel/node-exif) to extract the created date from an image. If the exif data is not available, picsort will try to extract the created date from the file's details, otherwise it will remain in the original location.

## Install
Remember to install the package globally 🌎 
If you are using npm, add `-g`

```
$ npm install -g picsort
```

If you are using yarn, add `global` just after `yarn` 
```
$ yarn global add picsort
```

## Usage
To sort your photos simply type `picsort` followed by the path to the source directory. 
```
$ picsort ./Desktop/images
```
**Tip:** You can also drag and drop folders! (see the demo)

To see all options or an usage example in command line, add flag `-h` or `--help`
```
$ picsort -h
$ picsort --help
```

## Options
Picsort will sort your photos in Year/Month order by default. However, you can specify sorting precision by adding a flag.

Use flag `-d` to sort photos by **Year/Month/Day/**. 
```
$ picsort [path] -d
````

Use flag `-m` to sort photos by **Year/Month/**. This is the default option. 
```
$ picsort [path] -m
````

Use flag `-y` to sort photos by **Year/**. 
```
$ picsort [path] -y
````

## Changelog
- **17/10/17** version 0.1.0 released,
- **25/02/18** using fs module to get file's created date,
- **26/02/18** v1 released 🚀

## License

[MIT License](https://github.com/mateuszjanusz/picsort/blob/master/LICENSE.md)

Mateusz Janusz, 2017.

picsort

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README