https://github.com/ysmood/renamefiles
A cli tool to safely batch rename files with sane defaults
https://github.com/ysmood/renamefiles
Last synced: 7 months ago
JSON representation
A cli tool to safely batch rename files with sane defaults
- Host: GitHub
- URL: https://github.com/ysmood/renamefiles
- Owner: ysmood
- License: mit
- Created: 2019-06-17T10:05:09.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-09-13T10:39:41.000Z (over 5 years ago)
- Last Synced: 2024-06-20T17:43:08.591Z (over 1 year ago)
- Language: Go
- Homepage:
- Size: 2.71 MB
- Stars: 11
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# renamefiles
[](http://godoc.org/github.com/ysmood/renamefiles)
[](https://travis-ci.org/ysmood/renamefiles)
[](https://codecov.io/gh/ysmood/renamefiles)
[](https://goreportcard.com/report/github.com/ysmood/renamefiles)
A CLI tool to safely batch rename files with sane defaults. Usually, you don't have to pass any arguments to make it work.
The quality of the statistic algorithm is defined by how hard to mock some file names to make the defaults not work as expected.
## Features
- Auto-detect the pattern with a [statistic based algorithm](lib/auto_pattern.go)
- Preview the renames before apply
- Command to revert the renames
## Install
Shell command `curl -L https://git.io/fjaxx | repo=ysmood/renamefiles sh`
or build from source code:
```bash
go get github.com/ysmood/renamefiles
```
For Windows go to the release page and download the binary.
## Usage
```bash
renamefiles --help-long
# usually, command without argument is enough
renamefiles
```
The tool will display a preview and ask if you want to apply the batch operation.
After the rename a log file will be created, you can use it to revert batch operation in case of mistakes.
For example, file list:
```txt
2001-abc-01.ass
2001-abc-02.ass
2001-abc-10.ass
readme.txt
```
The auto rename with `renamefiles --template "2013-{{key}}.ass"` will be:
```txt
2001-abc-01.ass -> 2013-01.ass
2001-abc-02.ass -> 2013-02.ass
2001-abc-10.ass -> 2013-10.ass
```
Because `readme.txt` is not similar to other files, it won't be touched.
## Dev
Release to github:
```bash
go get github.com/ysmood/kit/cmd/godev
godev build -d
```