nbir 1.1.0

Numeric Bulk Image Renamer (NBIR): rename image files to a sequential numbered scheme (e.g. base01.jpg, base02.png)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

# NBIR — Numeric Bulk Image Renamer

Rename image files in a directory to a sequential numbered scheme (e.g. `base01.jpg`, `base02.png`).

## Installation

From [crates.io](https://crates.io):

```bash
cargo install nbir
```

From source:

```bash
git clone https://github.com/yourusername/simplebulkfilerenamer
cd simplebulkfilerenamer
cargo install --path .
```

## Usage

**Interactive mode (no arguments):** Run `nbir` with no args. It will ask “Do you want to run it in the current directory? (y/n)” and, if yes, “Enter base name (e.g., spacewallpaper)”. Then it shows a preview and asks to proceed—like the original Python script.

**CLI mode:** Pass `--base-name` (and optionally `-d`, `-y`):

```bash
nbir [OPTIONS] [--base-name <NAME>]
```

### Options

| Short | Long | Default | Description |
|-------|------|---------|-------------|
| `-b` | `--base-name` | — | Base name for renamed files. If omitted, runs interactively and prompts for it. |
| `-d` | `--directory` | `.` | Directory containing images |
| `-y` | `--yes` | `false` | Skip confirmation; rename immediately |

### Examples

Interactive (prompts for directory and base name):

```bash
nbir
```

Preview renames in the current directory (will ask for confirmation):

```bash
nbir -b vacation
```

Rename immediately without prompting:

```bash
nbir -b vacation -y
```

Target a specific folder:

```bash
nbir -b thumbs -d ~/Pictures/screenshots
```

## Supported formats

`.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.bmp`, `.tiff`, `.tif` (case-insensitive)