{"id":13425129,"url":"https://github.com/laurent22/massren","last_synced_at":"2025-05-14T10:08:01.312Z","repository":{"id":13826151,"uuid":"16522792","full_name":"laurent22/massren","owner":"laurent22","description":"massren - easily rename multiple files using your text editor","archived":false,"fork":false,"pushed_at":"2024-12-08T14:50:22.000Z","size":2547,"stargazers_count":1375,"open_issues_count":12,"forks_count":38,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-04-13T03:59:15.071Z","etag":null,"topics":["go","linux","osx","rename-files","text-editor","windows"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laurent22.png","metadata":{"files":{"readme":"README.md","changelog":"history.go","contributing":null,"funding":null,"license":null,"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":"2014-02-04T19:25:06.000Z","updated_at":"2025-04-11T21:35:22.000Z","dependencies_parsed_at":"2024-06-18T20:07:42.578Z","dependency_job_id":"6aef85fe-66b2-4707-87bd-3e573cb7958d","html_url":"https://github.com/laurent22/massren","commit_stats":{"total_commits":161,"total_committers":14,"mean_commits":11.5,"dds":0.2422360248447205,"last_synced_commit":"93e8c66829a11c285650fa468c94cd5e5013e806"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laurent22%2Fmassren","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laurent22%2Fmassren/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laurent22%2Fmassren/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laurent22%2Fmassren/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laurent22","download_url":"https://codeload.github.com/laurent22/massren/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248661706,"owners_count":21141450,"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":["go","linux","osx","rename-files","text-editor","windows"],"created_at":"2024-07-31T00:01:05.586Z","updated_at":"2025-04-13T03:59:24.005Z","avatar_url":"https://github.com/laurent22.png","language":"Go","funding_links":[],"categories":["Go","\u003ca name=\"file-renamer\"\u003e\u003c/a\u003eFile renamers","Other","Command Line Tools","Repositories"],"sub_categories":[],"readme":"## Massren [![Build Status](https://travis-ci.org/laurent22/massren.svg?branch=master)](https://travis-ci.org/laurent22/massren)\n\nMassren is a command line tool that can be used to rename multiple files using your own text editor. Multiple-rename tools are usually difficult to use from the command line since any regular expression needs to be escaped, and each tool uses its own syntax and flavor of regex. The advantage of massren is that you are using the text editor you use every day, and so can use all its features.\n\nThe tool works by creating a file that contains the filenames of the target directory, and opening this file in the text editor. You can then modify the filenames there directly. Once done, save the text file and the files will be renamed. Lines that are not changed will simply be ignored.\n\n![Massren usage animation](https://raw.github.com/laurent22/massren/animation/animation.gif \"Massren usage animation\")\n\n## Features\n\n- Rename multiple files using your own text editor. It should work with any text editor, including vim, emacs, Sublime Text or notepad.\n\n- Undo - any rename operation can be undone.\n\n- Move files to sub-directories. See [these instructions](https://github.com/laurent22/massren/releases/tag/v1.4.0) for more information.\n\n- Dry run mode - test the results of a rename operation without actually renaming any file.\n\n- Cross-platform - Windows, OSX and Linux are supported.\n\n- Safety checks - since this is a multiple rename tool, various checks are in place to ensure that nothing gets accidentally renamed. For example, the program will check that the files are not being changed by something else while the list of filenames is being edited. If the number of files before and after saving the file is different, the operation will also be cancelled.\n\n## Installation\n\nThe latest executables for each platform are available from the [release page](https://github.com/laurent22/massren/releases).\n\n### Mac OS\n\nThe easiest way is with Homebrew:\n\n\tbrew install massren\n\nAlternatively, the Linux method described below should work.\n\t\nIf the installation fails, please follow the [instructions below](#building-from-source).\n\n### Linux\n\n- [Install Go](https://golang.org/doc/install#tarball)\n- Run `go install github.com/laurent22/massren@latest`\n\nBy default, the tool will be installed in `$GOPATH/bin/massren`. From there, you can either symlink it to `/bin` or add `$GOPATH/bin` to your `PATH` variable with `export PATH=$PATH:$GOPATH/bin`.\n\nNote that it is compatible with Linuxbrew, so the same commands as for Mac OS would work too.\n\n### Windows\n\nThe executable can be downloaded from https://github.com/laurent22/massren/releases\n\nNote: Windows releases are discontinued as of version 1.3, as I do not know if they are used by anyone. The program still works with Windows though, and can be built and installed using the \"Linux\" method above. If you have any interest in maintaining the Windows releases, please let me know.\n\n## Usage and examples\n\n\tUsage:\n\t  massren [OPTIONS]\n\n\tApplication Options:\n\t  -n, --dry-run  Don't rename anything but show the operation that would have\n\t                 been performed.\n\t  -v, --verbose  Enable verbose output.\n\t  -c, --config   Set or list configuration values. For more info, type:\n\t                 massren --config --help\n\t  -u, --undo     Undo a rename operation. Currently delete operations cannot be\n\t                 undone (though files can be recovered from the trash in OSX\n\t                 and Windows). eg. massren --undo [path]\n\t  -V, --version  Displays version information.\n\n\tHelp Options:\n\t  -h, --help     Show this help message\n\n\tExamples:\n\n\t  Process all the files in the current directory:\n\t  % massren\n\n\t  Process all the JPEGs in the specified directory:\n\t  % massren /path/to/photos/*.jpg\n\n\t  Undo the changes done by the previous operation:\n\t  % massren --undo /path/to/photos/*.jpg\n\n\t  Set VIM as the default text editor:\n\t  % massren --config editor vim\n\n\t  List config values:\n\t  % massren --config\n\n## Configuration\n\nType `massren --help --config` (or `massren -ch`) to view the possible configuration values and defaults:\n\n\tConfig commands:\n\n\t  Set a value:\n\t  % massren --config \u003cname\u003e \u003cvalue\u003e\n\n\t  List all the values:\n\t  % massren --config\n\n\t  Delete a value:\n\t  % massren --config \u003cname\u003e\n\n\tPossible key/values:\n\n\t  editor:              The editor to use when editing the list of files.\n\t                       Default: auto-detected.\n\n\t  use_trash:           Whether files should be moved to the trash/recycle bin\n\t                       after deletion. Possible values: 0 or 1. Default: 1.\n\n\t  include_directories: Whether to include the directories in the file buffer.\n\t                       Possible values: 0 or 1. Default: 1.\n\n\t  include_header:      Whether to show the header in the file buffer. Possible\n\t                       values: 0 or 1. Default: 1.\n\n\tExamples:\n\n\t  Set Sublime as the default text editor:\n\t  % massren --config editor \"subl -n -w\"\n\n\t  Don't move files to trash:\n\t  % massren --config use_trash 0\n\n## TODO\n\n- Move files to trash in bulk instead of one by one.\n- Detect default text editor on Windows.\n- Disambiguate filenames when processing two or more folders that contain the same filenames.\n- Other [various issues](https://github.com/laurent22/massren/issues).\n\n## Building from source\n\n- Go 1.17+ is required\n\n\t\tgo mod tidy\n\t\tgo build\n\n## Test units\n\nMassren functionalities are supported by a robust test suite that has nearly complete code coverage. To run the test units, type `go test -v` from the source code directory.\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2013-2025 Laurent Cozic\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaurent22%2Fmassren","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaurent22%2Fmassren","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaurent22%2Fmassren/lists"}