-
-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.html
658 lines (655 loc) · 31.6 KB
/
readme.html
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<title></title>
<style type="text/css">code{white-space: pre;}</style>
<style type="text/css">
div.sourceCode { overflow-x: auto; }
table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode {
margin: 0; padding: 0; vertical-align: baseline; border: none; }
table.sourceCode { width: 100%; line-height: 100%; }
td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; }
td.sourceCode { padding-left: 5px; }
code > span.kw { color: #007020; font-weight: bold; } /* Keyword */
code > span.dt { color: #902000; } /* DataType */
code > span.dv { color: #40a070; } /* DecVal */
code > span.bn { color: #40a070; } /* BaseN */
code > span.fl { color: #40a070; } /* Float */
code > span.ch { color: #4070a0; } /* Char */
code > span.st { color: #4070a0; } /* String */
code > span.co { color: #60a0b0; font-style: italic; } /* Comment */
code > span.ot { color: #007020; } /* Other */
code > span.al { color: #ff0000; font-weight: bold; } /* Alert */
code > span.fu { color: #06287e; } /* Function */
code > span.er { color: #ff0000; font-weight: bold; } /* Error */
code > span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
code > span.cn { color: #880000; } /* Constant */
code > span.sc { color: #4070a0; } /* SpecialChar */
code > span.vs { color: #4070a0; } /* VerbatimString */
code > span.ss { color: #bb6688; } /* SpecialString */
code > span.im { } /* Import */
code > span.va { color: #19177c; } /* Variable */
code > span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code > span.op { color: #666666; } /* Operator */
code > span.bu { } /* BuiltIn */
code > span.ex { } /* Extension */
code > span.pp { color: #bc7a00; } /* Preprocessor */
code > span.at { color: #7d9029; } /* Attribute */
code > span.do { color: #ba2121; font-style: italic; } /* Documentation */
code > span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code > span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code > span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
</style>
</head>
<body>
<p><a href="https://travis-ci.org/neurobin/rnm"><img src="https://travis-ci.org/neurobin/rnm.svg?branch=release" alt="Build Status" /></a></p>
<div id="description">
</div>
<p>Renames files/directories in bulk. Naming scheme (<em>Name String</em>) can be applied or regex replace can be performed to modify file names on the fly. It uses PCRE2 (revised version of PCRE) regex to provide search (and replace) functionality.</p>
<p>It provides versatile options to modify names, delete/replace part of it, indexing, case conversion, insert text, insert various file information like modification time, access time, permission etc.., insert parent directory names, working directory name etc.. and many more.</p>
<p>File search functionality is provided with PCRE2 regex. Fixed string search is also possible.</p>
<p>Operations (rename, changing names, search) are selective of file type (directory, file, link).</p>
<p>Files can be sorted by name, modification time, access time, size, file type (directory, file, link) etc..</p>
<p>It provides an undo functionality to move back unwanted rename operations. Different <strong>rnm</strong> operation on different directory remembers their own undo history.</p>
<p>Simulations can be run instead of actual rename to view the potential outcome as program output on terminal with the <em>-sim</em> option.</p>
<h1 id="features-at-a-glance">Features at a glance:</h1>
<ol style="list-style-type: decimal">
<li>Rename files/directories/links en masse with dynamically constructed names.</li>
<li>Undo rename.</li>
<li>Names (or name strings) can be taken from a file.</li>
<li>Inserting file information (mtime, atime, ctime, permission etc..) in arbitrary formats.</li>
<li>Indexing and formatting the indexes in different ways.</li>
<li>Latin, scientific and base conversion for indexes and counters.</li>
<li>Inserting different level of parent directory names.</li>
<li>Access to current directory name, file name with and without extension.</li>
<li>Regex replace to delete/swap/replace part of the file name.</li>
<li>A regex replace operation can be performed on file only, directory only, link only or any combination of them.</li>
<li>Uppercase/Lowercase conversion on file name (can be done by selecting a part).</li>
<li>Replace strings can be taken from files.</li>
<li>Search string to search for files with matching regex/string.</li>
<li>Search string can be specified for only file, directory, link or any combination of them.</li>
<li>Inverse search.</li>
<li>Search strings can be taken from files.</li>
<li>Sorting files and indexing.</li>
<li>Sorting files according to size, modification time, access time etc..</li>
<li>Prioritize file, directory or link during sort.</li>
<li>Running simulation.</li>
</ol>
<h1 id="new-features">New features:</h1>
<ol style="list-style-type: decimal">
<li>Unlimited precision for numbers i.e you can perform base conversion, scientific conversion etc.. on an arbitrarily big number. This functionality is provided by GMP BigNum library (GNU Multi-precession library).</li>
<li>File information is available, e.g modification time, access time, status change time (time string can be formatted using format string e.g <code>%d-%m-%Y</code>), permission, owner id, group id, size, block, inode number, mode etc...</li>
<li>Inverse search is possible.</li>
<li>Each regex operation can be associated with either link, file or directory, for example, if a replace string is associated with only file, it will not work on directories or links.</li>
<li>New sorting methods:</li>
<li>Sort according to file modification time (recent first).</li>
<li>Sort according to file access time (recent first).</li>
<li>Sort according to file status change time (recent first).</li>
<li>Sort according to file size (larger first).</li>
<li>Prioritize directory when sorting.</li>
<li>Prioritize file when sorting.</li>
<li>Prioritize link when sorting.</li>
<li>Reverse sort (can be used to reverse the order of a previous sort).</li>
</ol>
<h1 id="install">Install:</h1>
<h2 id="for-ubuntu-and-derivatives">For Ubuntu and derivatives:</h2>
<p>You can install it in Ubuntu from neurobin PPA (<code>ppa:neurobin/ppa</code>).</p>
<pre class="sh"><code>sudo add-apt-repository -y ppa:neurobin/ppa
sudo apt-get update
sudo apt-get install rnm</code></pre>
<p>If you are in precise (12.04), you will need to add ubuntu-toolchain repository to make <code>libstdc++6 (>=4.8.4)</code> available:</p>
<pre class="sh"><code>sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
sudo add-apt-repository -y ppa:neurobin/ppa
sudo apt-get update
sudo apt-get install rnm</code></pre>
<h2 id="for-archlinux">For Archlinux:</h2>
<p>Install from AUR:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">git</span> clone https://aur.archlinux.org/rnm.git
<span class="kw">cd</span> rnm
<span class="kw">makepkg</span> -i</code></pre></div>
<h2 id="for-macos">For MacOS:</h2>
<p>Install from <code>neurobin/pkg/rnm</code> with <code>brew</code>:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">brew</span> install neurobin/pkg/rnm</code></pre></div>
<h2 id="from-pre-built-binaries">From pre-built binaries:</h2>
<p>You can download a pre-built binary (64 bit, 32 bit, ppc64el) from the <a href="https://github.com/neurobin/rnm/releases">release page</a> if available. These pre-built binaries depend on <code>libstdc++6 >= 4.8.4</code> if not specified otherwise.</p>
<h2 id="from-source">From source:</h2>
<p>Make sure you have a C++ compiler equivalent to GCC-4.8 (<code>g++-4.8</code>) or later installed on your system.</p>
<h4 id="download-dependencies">Download dependencies:</h4>
<p>It depends on three different libraries:</p>
<ol style="list-style-type: decimal">
<li><a href="http://pcre.org/">pcre2</a></li>
<li><a href="https://github.com/jpcre2/jpcre2">jpcre2</a></li>
<li><a href="https://gmplib.org/">gmplib</a></li>
</ol>
<p>To install dependencies run the <code>prepare.sh</code> file:</p>
<pre class="sh"><code>cd rnm # i.e go inside the rnm project directory
#Creating the following directories will prevent prepare.sh from installing the corresponding libraries.
#mkdir -p gmpxx # uncomment and run this command if libgmp-dev (gmpxx) is already installed.
#mkdir -p pcre2 # uncomment and run this command if libpcre2-dev (pcre2) is already installed.
#mkdir -p jpcre2 # uncomment and run this command if libjpcre2-dev (jpcre2) is already installed.
sh prepare.sh</code></pre>
<h4 id="install-rnm">Install rnm:</h4>
<p>After you have all the dependencies at hand, you can simply do:</p>
<pre class="sh"><code>autoreconf -f -i #run this one if your automake version is less than 1.15
./configure --prefix=/usr
make
sudo make install</code></pre>
<div id="un-install">
</div>
<h1 id="uninstall">Uninstall:</h1>
<ol style="list-style-type: decimal">
<li>For Debian, Ubuntu and derivatives, uninstall from software manager.</li>
<li>For Archlinux, uninstall with pacman.</li>
<li>For MacOS, uninstall with <code>brew uninstall rnm</code></li>
<li>If you used a pre-built binary, just delete the binary and the man page.</li>
<li>If you compiled from the source, do <code>./configure --prefix=/usr && make && sudo make uninstall</code></li>
</ol>
<h1 id="basic-options">Basic options</h1>
<ul>
<li><code>-ns</code>: Name string, simply new name for files. String wrapped with <code>/</code> are treated as special rules and expanded to their special meaning.</li>
<li><code>-rs</code>: Replace string. Performs regex replace to construct new name.</li>
<li><code>-ss</code>: Searches files with matching regex.</li>
<li><code>-ssf</code>: Searches files with matching fixed string.</li>
<li><code>-s</code>: Sort files.</li>
<li><code>-fo</code>: File only mode.</li>
<li><code>-do</code>: Directory only mode.</li>
<li><code>-lo</code>: Link only mode.</li>
<li><code>-dp</code>: Depth of directories (how many subdirs to recurse).</li>
<li><code>-u</code>: Undo the last rename operation in the current directory.</li>
<li><code>-up</code>: Undo rename from an arbitrary undo path.</li>
<li><code>-ups</code>: Show available undo paths.</li>
<li><code>-duh</code>: Delete undo history older than the given seconds.</li>
<li><code>-duhd</code>: Delete undo history older than the given days.</li>
</ul>
<p>For a complete list of options and to get a glimpse of what <strong>rnm</strong> is capable of, get a peek at the doc (<code>rnm.md</code> or <a href="https://docs.neurobin.org/man/man1/rnm.html">rnm.html</a>) or man page (<code>man rnm</code>).</p>
<div id="usage">
</div>
<h1 id="usage">Usage:</h1>
<p><strong>Simplest example:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns newname oldfile
<span class="co">#rename by adding something to oldname:</span>
<span class="kw">rnm</span> -ns <span class="st">'/fn/ some text to add'</span> oldfile</code></pre></div>
<blockquote>
<p><code>/fn/</code> is a name string rule that expands to file name.</p>
</blockquote>
<h2 id="indexing">Indexing</h2>
<p><strong>Rename all by appending index to file names:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/n/ /i/./e/'</span> ./* -dp -1</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file.mp3</td>
<td align="left">file 1.mp3</td>
</tr>
<tr class="even">
<td align="left">song.mp3</td>
<td align="left">song 2.mp3</td>
</tr>
<tr class="odd">
<td align="left">video/song.mp4</td>
<td align="left">video/song 3.mp4</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>/n/</code> is a name string rule which expands to file name without extension of the current renaming file. <code>/e/</code> is a name string rule which expands to file extension. <code>/i/</code> is another name string rule which expands to index. <code>-dp -1</code> means unlimited depth i.e go to all subdirs.</p>
</blockquote>
<p><strong>Rename all by appending directory wise index to file names:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/n/ /id/./e/'</span> ./* -dp -1</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">dir1/file.mp3</td>
<td align="left">dir1/file 1.mp3</td>
</tr>
<tr class="even">
<td align="left">dir1/song.mp3</td>
<td align="left">dir1/song 2.mp3</td>
</tr>
<tr class="odd">
<td align="left">dir2/file.mp3</td>
<td align="left">dir2/file 1.mp3</td>
</tr>
<tr class="even">
<td align="left">dir2/song.mp3</td>
<td align="left">dir2/song 2.mp3</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>/id/</code> is a name string rule which expands to directory index (index inside directory).</p>
</blockquote>
<p><strong>Index with leading zeros ( file 001, 002 etc..):</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/n/ /id/./e/'</span> -ifl 4 ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file.mp3</td>
<td align="left">file 0001.mp3</td>
</tr>
<tr class="even">
<td align="left">song.mp3</td>
<td align="left">song 0002.mp3</td>
</tr>
<tr class="odd">
<td align="left">...</td>
<td align="left">...</td>
</tr>
<tr class="even">
<td align="left">video.mp4</td>
<td align="left">video 0010.mp4</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>-ifl 4</code> sets index field length to 4 and thus remaining space is filled with 0 (by default).</p>
</blockquote>
<p><strong>Use custom increment value:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/n/ /id/./e/'</span> -ifl 2 -inc 4 ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file.mp3</td>
<td align="left">file 01.mp3</td>
</tr>
<tr class="even">
<td align="left">song.mp3</td>
<td align="left">song 05.mp3</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>-inc 4</code> sets the index increment value to 4.</p>
</blockquote>
<p><strong>Decreasing index:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/n/ /-id/./e/'</span> -ifl 3 -inc 4 ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file.mp3</td>
<td align="left">file -001.mp3</td>
</tr>
<tr class="even">
<td align="left">song.mp3</td>
<td align="left">song -005.mp3</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>-inc</code> is always positive, but decremented index can be accessed by appending <code>-</code> in (at beginning) them.</p>
</blockquote>
<p><strong>Set starting index:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/n/ /id/./e/'</span> -ifl 3 -inc 4 -si 4 ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file.mp3</td>
<td align="left">file 004.mp3</td>
</tr>
<tr class="even">
<td align="left">song.mp3</td>
<td align="left">song 008.mp3</td>
</tr>
</tbody>
</table>
<blockquote>
<p>There are lots of magics you can do with index, like converting to binary, octal, hexadecimal etc.., converting to scientific or latin number, use index flags to manipulate their format etc.. Refer to the doc (rnm.md or <a href="https://docs.neurobin.org/man/man1/rnm.html">rnm.html</a>) or man page (<code>man rnm</code>) for complete details.</p>
</blockquote>
<h2 id="changemodifyremove-part-of-a-file-name">Change/Modify/remove part of a file name</h2>
<p><strong>rnm uses PCRE2 regex</strong> to provide regex replace on old filename. The general format for regex replace:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="st">'/regex/replace/modifier'</span></code></pre></div>
<p>where <code>regex</code> is the regex to match in the file name, replace is the string to replace the match with and modifiers are : g (global) i (case insensitive), d (directory), f (file), l (link).</p>
<p><strong>swap parts:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -rs <span class="st">'/(.*)_(.*)\.mp3/\2_\1.mp3/'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">test_file.mp3</td>
<td align="left">file_test.mp3</td>
</tr>
<tr class="even">
<td align="left">test_song.mp3</td>
<td align="left">song_test.mp3</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>-rs</code> takes a replace string of the form <code>/regex/replace/modifier</code> <code>\1</code> is captured group one, <code>\2</code> is captured group 2.</p>
</blockquote>
<p><strong>Replace all _ (underscore) to space:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -rs <span class="st">'/_/ /g'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">test_file_123.mp3</td>
<td align="left">test file 123.mp3</td>
</tr>
<tr class="even">
<td align="left">test_song_456.mp3</td>
<td align="left">test song 456.mp3</td>
</tr>
</tbody>
</table>
<p><strong>Change all .mp3 to .MP3 (uppercase):</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -rs <span class="st">'/\.mp3/\C/g'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">test_file_123.mp3</td>
<td align="left">test_file_123.MP3</td>
</tr>
<tr class="even">
<td align="left">test_song_456.mp3</td>
<td align="left">test_song_456.MP3</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>\C</code> (capital C) in replace part converts the matched part to uppercase</p>
</blockquote>
<p><strong>Change all before <code>_</code> to (lowercase) and all after <code>.</code> to (uppercase):</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -rs <span class="st">'/.*_/\c/;/.*\./\C/g'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">TEST_file_123.mp3</td>
<td align="left">test_file_123.MP3</td>
</tr>
<tr class="even">
<td align="left">TEST_song_456.mp3</td>
<td align="left">test_song_456.MP3</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>\c</code> (small c) in replace part converts to lowercase.</p>
</blockquote>
<p><strong>Insert .link at the end for files that are symbolic link:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -rs <span class="st">'/$/.link/l'</span> ./*</code></pre></div>
<blockquote>
<p>the <em>l</em> modifier tells it to perform the replacement only to symbolic links, other modifiers <em>f</em> and <em>d</em> are available for files and directories respectively.</p>
</blockquote>
<blockquote>
<p>rnm comes with the power of PCRE2 regex and thus you can perform almost all kinds of file name modifications using regex replace. Name string rules ( <code>/fn/</code>, <code>/i/</code> etc..) are applicable inside regex or replace part. If you have lots of regex replace to perform, you can put them into a file and give the file path with <code>-rs/f</code> option. This option can be given multiple times to add multiple files. <code>-rs</code> option can also be given multiple times to add multiple replace string. Also replace string can be terminated with <code>;</code> to add another replace string after it.</p>
</blockquote>
<blockquote>
<p>See the doc (rnm.md or <a href="https://docs.neurobin.org/man/man1/rnm.html">rnm.html</a>) or man page for complete details regarding regex replace.</p>
</blockquote>
<h2 id="search-for-files-and-rename">Search for files and rename:</h2>
<h3 id="search-with-regex">Search with regex:</h3>
<p><strong>Rename .mp3 files to .dummy:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/.dummy'</span> -ss <span class="st">'\.mp3$'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file1.mp3</td>
<td align="left">file1.mp3.dummy</td>
</tr>
<tr class="even">
<td align="left">file2.mp3</td>
<td align="left">file2.mp3.dummy</td>
</tr>
<tr class="odd">
<td align="left">file3.mp4</td>
<td align="left">file3.mp4</td>
</tr>
</tbody>
</table>
<p><strong>Rename all symbolic links to .link:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/.link'</span> -ss <span class="st">'//l'</span></code></pre></div>
<blockquote>
<p><code>//l</code> and empty search string matches anything in file name. the <em>l</em> modifier tells it to match link, other modifiers <em>f</em> and <em>d</em> are available for files and directories respectively.</p>
</blockquote>
<h3 id="search-with-fixed-string">Search with fixed string:</h3>
<p><strong>Rename .mp3 files to .dummy:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/.dummy'</span> -ssf <span class="st">'.mp3'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file1.mp3</td>
<td align="left">file1.mp3.dummy</td>
</tr>
<tr class="even">
<td align="left">file2.mp3</td>
<td align="left">file2.mp3.dummy</td>
</tr>
<tr class="odd">
<td align="left">file3.mp4</td>
<td align="left">file3.mp4</td>
</tr>
</tbody>
</table>
<blockquote>
<p>In this case .mp3 can match at the middle or start too.</p>
</blockquote>
<h3 id="inverse-search">Inverse search:</h3>
<p><strong>Rename all files except .mp3 to .dummy:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/.dummy'</span> -ss <span class="st">'/\.mp3$/!'</span> ./*
<span class="co">#or with fixed string:</span>
<span class="kw">rnm</span> -ns <span class="st">'/fn/.dummy'</span> -ssf <span class="st">'/.mp3/!'</span> ./*
<span class="co">#for fixed string search, .mp3 will match at any place in the name</span></code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file1.mp3</td>
<td align="left">file1.mp3</td>
</tr>
<tr class="even">
<td align="left">file2.mp3</td>
<td align="left">file2.mp3</td>
</tr>
<tr class="odd">
<td align="left">file3.mp4</td>
<td align="left">file3.mp4.dummy</td>
</tr>
</tbody>
</table>
<blockquote>
<p>If you have lots of search strings, you can put them into files and add those files with <code>-ss/f</code> option. This option can be given multiple time to add multiple files. <code>-ss</code> option can also be given multiple times to add multiple search string. See the docs (rnm.md or <a href="https://docs.neurobin.org/man/man1/rnm.html">rnm.html</a>) or man page for more ways and details.</p>
</blockquote>
<h2 id="sort-and-rename">Sort and rename:</h2>
<p>There are several sorting mechanisms available:</p>
<ol style="list-style-type: decimal">
<li><code>-s</code> : default sort (natural sort)</li>
<li><code>-s/g</code> : general sort</li>
<li><code>-s/n</code> : natural sort</li>
<li><code>-s/mt</code> : sort according to file modification time (recent first)</li>
<li><code>-s/at</code> : sort according to file access time (recent first)</li>
<li><code>-s/ct</code> : sort according to file status change time (recent first)</li>
<li><code>-s/sz</code> : sort according to file size (larger first)</li>
<li><code>-s/d</code> : prioritize directory when sorting</li>
<li><code>-s/f</code> : prioritize file when sorting</li>
<li><code>-s/l</code> : prioritize link when sorting</li>
<li><code>-s/r</code> : reverse the order sorted by above methods.</li>
</ol>
<p>The default sort which comes with the option <code>-s</code> is natural sort (<code>-s/n</code>).</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/ /id/'</span> -s ./*</code></pre></div>
<h2 id="insert-file-information">Insert file information</h2>
<p><strong>Add file modification time to file name:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/ @ /info-mtime-%d-%m-%Y %H:%I %p/'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">file1</td>
<td align="left">file1 @ 27-01-2017 12:35 AM</td>
</tr>
<tr class="even">
<td align="left">file2</td>
<td align="left">file2 @ 17-01-2017 10:34 PM</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>/info-prop-op/</code> is another name string rule, <code>prop</code> is the property name (mtime, atime, perm, uid etc..) and <code>op</code> is the format (optional).</p>
</blockquote>
<p><strong>Add file permission to file name:</strong></p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/ /info-perm-ls/'</span> ./*</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">dir1</td>
<td align="left">dir1 drwx--x--x</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>perm</code> is another property for info name string rule, <code>op=ls</code> is for permission resembling to <code>ls</code> command, <code>oct</code> is for octal permission.</p>
</blockquote>
<blockquote>
<p>There are lots of properties available for file info which makes all kinds of file information available. See the docs (rnm.md or <a href="https://docs.neurobin.org/man/man1/rnm.html">rnm.html</a>) or man page for details.</p>
</blockquote>
<h1 id="miscellaneous-examples">Miscellaneous examples</h1>
<h2 id="addinsert-parent-directory-names-to-filename">Add/Insert parent directory names to filename:</h2>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/pd0/-/fn/'</span> dir1/*.png</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">dir1/abc.png</td>
<td align="left">dir1/dir1-abc.png</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>/pd0/</code> is the immediate parent directory</p>
</blockquote>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/pd1-0--/-/fn/'</span> dir1/dir0/*.png</code></pre></div>
<table>
<thead>
<tr class="header">
<th align="left">Before</th>
<th align="left">After</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">dir1/dir0/abc.png</td>
<td align="left">dir1/dir0/dir1-dir0-abc.png</td>
</tr>
</tbody>
</table>
<blockquote>
<p><code>/pd1-0--/</code> adds the directory names from <code>/pd1/</code> to <code>/pd0/</code> with a delimiter in-between. <code>/pd0-1- /</code> would become <code>dir0 dir1</code> (here space is the delimiter). The general format is: <code>/pd<from>-<to>-<delimiter>/</code></p>
</blockquote>
<h2 id="index-files-by-sorting-them-according-to-modification-time">Index files by sorting them according to modification time:</h2>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/ /ir/'</span> -s/mt ./*</code></pre></div>
<blockquote>
<p>The above will append index to the filenames by sorting the files according to modification time (recent first). <code>/ir/</code> is reserved-index (index is reserved for skipped files), <code>-s/mt</code> sorts according to mtime.</p>
</blockquote>
<h2 id="index-files-by-sorting-them-according-to-size">Index files by sorting them according to size:</h2>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/ /ir/'</span> -s/sz ./*</code></pre></div>
<blockquote>
<p>The above will append index to the filenames by sorting the files according to size (larger first).</p>
</blockquote>
<h2 id="treat-files-directories-links-differently-in-a-single-command-to-rename-files">Treat files, directories, links differently in a single command to rename files:</h2>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -rs <span class="st">'/_/-/gf'</span> -rs <span class="st">'/\./-/gd'</span> -rs <span class="st">'/$/.link/l'</span> ./*</code></pre></div>
<p>This is what the above command does:</p>
<ol style="list-style-type: decimal">
<li>Replace all underscores with hyphen for regular files (<code>/_/-/gf</code>).</li>
<li>Replace all dot with hyphen for directories (<code>/\./-/gd</code>).</li>
<li>Give all symbolic links a .link extension (<code>/$/.link/l</code>).</li>
</ol>
<h2 id="search-for-files-matching-pattern1-in-their-name-directories-matching-pattern2-and-links-matching-pattern3-and-append-modification-time-with-the-filename">Search for files matching pattern1 in their name, directories matching pattern2 and links matching pattern3 and append modification time with the filename:</h2>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">rnm</span> -ns <span class="st">'/fn/ /info-mtime-%d-%m-%Y %H:%I %p/'</span> -ss <span class="st">'/pattern1/f'</span> -ss <span class="st">'/pattern2/d'</span> -ss <span class="st">'/pattern3/l'</span> ./*</code></pre></div>
<p><a href="https://docs.neurobin.org/man/man1/rnm.html">rnm user manual</a></p>
<p><a href="https://neurobin.org/docs/unix/rnm/bulk-rename-in-linux/">Other examples</a></p>
</body>
</html>