Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amdmi3/gopro-rename
Fix silly filenames from GoPro action cameras
https://github.com/amdmi3/gopro-rename
gopro rename-files
Last synced: about 4 hours ago
JSON representation
Fix silly filenames from GoPro action cameras
- Host: GitHub
- URL: https://github.com/amdmi3/gopro-rename
- Owner: AMDmi3
- License: mit
- Created: 2016-08-19T17:37:20.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-05-26T19:22:22.000Z (over 2 years ago)
- Last Synced: 2023-03-11T16:07:57.413Z (over 1 year ago)
- Topics: gopro, rename-files
- Language: Python
- Size: 28.3 KB
- Stars: 17
- Watchers: 6
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: COPYING
Awesome Lists containing this project
README
# gopro-rename
[](https://github.com/AMDmi3/gopro-rename/actions/workflows/ci.yml)
[GoPro](https://gopro.com) action cameras have totally inconvenient [file naming convention](https://community.gopro.com/s/article/GoPro-Camera-File-Naming-Convention), which is, for instance, completely unfriendly to sorting. Example:
```
GOPR0001.MP4 # video 1 start
GOPR0002.MP4
GOPR0003.MP4
GP010001.MP4 # video 1 continued
GP010002.MP4
GP010003.MP4
GP020001.MP4 # video 1 last part
```
This script renames files an a more sane way:
```
GoPro_0001_00.MP4 # video 1 start
GoPro_0001_01.MP4 # video 1 continued
GoPro_0001_02.MP4 # video 1 last part
GoPro_0002_00.MP4
GoPro_0002_01.MP4
GoPro_0003_00.MP4
GoPro_0003_01.MP4
```
## Usage
```
gopro-rename [-nfvr] [-p prefix] path [path ...]
```
The program takes arbitrary number of paths as arguments. If file
path is given, it's processed directly, if directory path is given,
all files in the given directory are processed (by default the
script does not ascend into subdirectories, but this behavior may
be changed by **-r** flag). Processing involves checking whether a
file name looks like it has been produced by GoPro and renaming the
file (unless **-n** flag was specified), with an option to set the
file prefix instead of a default "GoPro_". The files which do not
match GoPro file naming convention are silently ignored.
Additional flags:
* **-n**, **--dry-run** - do not rename files, just print renames to stderr
* **-f**, **--force** - rename file even if destination path exists
* **-v**, **--verbose** - print performed renames to stderr
* **-r**, **-R**, **--recursive** - process subdirectories recursively
* **-p**, **--prefix** - set the filename prefix instead of the default "GoPro_"
## Requirements
Only python interpreter is required, of version 3.6 or higher
## Author
* [Dmitry Marakasov](https://github.com/AMDmi3)
## Contributors
* [Manu Erwin](https://github.com/manuerwin)
## License
MIT, see COPYING.