https://github.com/chriskyfung/dropbox-file-renamer
Batch rename multiple Dropbox files using Dropbox API V2
https://github.com/chriskyfung/dropbox-file-renamer
dropbox dropbox-api nodejs rename-files renamer
Last synced: about 2 months ago
JSON representation
Batch rename multiple Dropbox files using Dropbox API V2
- Host: GitHub
- URL: https://github.com/chriskyfung/dropbox-file-renamer
- Owner: chriskyfung
- License: gpl-3.0
- Created: 2023-04-13T13:06:02.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-26T15:48:53.000Z (over 1 year ago)
- Last Synced: 2025-01-09T01:48:04.097Z (4 months ago)
- Topics: dropbox, dropbox-api, nodejs, rename-files, renamer
- Language: JavaScript
- Homepage:
- Size: 29.3 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Batch Rename Multiple Dropbox Files using Dropbox API V2
This example uses [the Official Dropbox API V2 SDK for Javascript](https://github.com/dropbox/dropbox-sdk-js) to search and rename files.
## Installation ðŸ›
1. Create an app via the [Developer Console](https://dropbox.com/developers/apps)
2. In the Developer Console, navigate to the **App Console** > *Your Application* > **Permissions** to add **`files.metadata.read`** and **`files.content.write`** permissions to your app scopes
3. Install from the source:
```shell
git clone https://github.com/chriskyfung/dropbox-file-renamer.git
cd dropbox-file-renamer
npm install
```
4. Create a `.env` file in your project directory
5. Generate and copy the access token from the App Console to `.env` file, for example:
```plain
ACCESS_TOKEN=your_access_token
```
## How to Use 🔰
1. Open the `index.js` file in Visual Studio Code
2. Modify the query string passed to the `filesSearchV2()` to search for your target files
3. Modify the regular expression and replacement for the `filename.replace()` methods to generate the new filenames of the matched files
4. Run the script using
```shell
node index.js
```
or
```shell
npm start
```
## Examples
You can execute an example script using the following command in your terminal:
```shell
node ./example/[target-script-name].js
```
- `file_search_v2.js` - Searches for files and folders using the `/files/search_v2` and `/files/search/continue_v2` endpoints
- `ilst_folder.js` - Lists the items of a folder using the `/files/list_folder` and `/files/list_folder/continue` endpoints
## Learn More 📚
- [**Dropbox API Explorer**](https://dropbox.github.io/dropbox-api-v2-explorer)
- [search_v2Switch](https://dropbox.github.io/dropbox-api-v2-explorer/#files_search_v2) - \[ [Docs](https://www.dropbox.com/developers/documentation/http/documentation#files-search) \]
- [move_batch_v2](https://dropbox.github.io/dropbox-api-v2-explorer/#files_move_batch_v2) - \[ [Docs](https://www.dropbox.com/developers/documentation/http/documentation#files-move_batch) \]
- [Search Files Using the Dropbox API - Dropbox](https://dropbox.tech/developers/search-files-using-the-dropbox-api)
## Like my stuff?
Would you like to buy me a coffee? I would really appreciate it if you could support me for the development.
## License
Distributed under the [GNU Affero General Public License v3.0](LICENSE)