Skip to content

Commit 129c0a6

Browse files
2 parents 6d9c0d3 + c633444 commit 129c0a6

File tree

1 file changed

+47
-19
lines changed

1 file changed

+47
-19
lines changed

README.md

+47-19
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,43 @@
11
[![Screenshot1](doc/screenshot1.png)](https://github.com/David-Maisonave/TranslateFileNames)
2+
23
# Translate File Names
34
Includes both a windows GUI and a command line utility to translate and rename files from their source language to the set language. By default, the set language is the local system TwoLetterISOLanguageName.
45

56
## What does it do?
67

7-
The program renames all the files from their source language to the specified target language (default: locale).
8+
This program renames all files in a folder from their source language to the specified target language (default: locale).
89

910
Example use-case:
1011
Translate foreign movie *.mp4 file names.
1112
Translate names of songs ripped from an imported foreign album.
1213

14+
# Content
15+
16+
[Features](README.md#Features)
17+
- [Translates all file names in folder](README.md#Translates-all-file-names-in-folder)
18+
- [Modify translated name](README.md#Modify-translated-name)
19+
- [Search Recursively](README.md#Search-Recursively)
20+
- [Long Path Support](README.md#Long-Path-Support)
21+
- [Append Original Name](README.md#Append-Original-Name)
22+
- [Append Language Name](README.md#Append-Language-Name)
23+
- [File Type](README.md#File-Type)
24+
- [Max Threads](README.md#Max-Threads)
25+
- [Max Translation Len](README.md#Max-Translation-Len)
26+
- [Files-Per-Translation-Req](README.md#Files-Per-Translation-Req)
27+
- [Target Language](README.md#Target-Language)
28+
- [Source Language](README.md#Source-Language)
29+
- [Filter](README.md#Filter)
30+
31+
[Console Program](README.md#Console-Program)
32+
33+
[Author](README.md#Author)
34+
35+
[License](README.md#License)
36+
1337

14-
# Features
38+
## Features
1539

16-
### 1. Translates all file names in selected folder.
40+
#### Translates all file names in folder
1741

1842
Scans all files in selected folder, and only displays files having names in different language from the targetted language.
1943

@@ -38,44 +62,47 @@ File renaming does not occur untill one of the following options is selected.
3862

3963
Renames only files which have not been checked.
4064

65+
#### Filter
4166

67+
This option allows user to use keywords to find or filter the list to only items having the keyword(s).
4268

69+
When this option is used, and the "Rename All" option is selected, only the resulting filtered items displayed are renamed.
4370

44-
### 2. Modify translated name
71+
#### Modify translated name
4572

4673
The translated name on the list, can be edited before performing the rename action.
4774

48-
### 3. Search Recursively
75+
#### Search Recursively
4976

5077
By default, only the files on the root directory are scanned, but by selecting this option, the scan will also search all sub folders.
5178

52-
### 4. Long Path Support
79+
#### Long Path Support
5380

5481
By selecting this option, the rename will occur even if the full path is longer then 255 characters.
5582

56-
### 5. Append Original Name
83+
#### Append Original Name
5784

5885
When selected, this options includes the original file name when renaming the file. Example: TranslatedName(OriginalName).gif
5986

60-
### 6. Append Language Name
87+
#### Append Language Name
6188

6289
When selected, appends the source language name to the renamed file. Example: TranslatedName_[Russian].gif
6390

64-
### 7. File Type
91+
#### File Type
6592

6693
This option can be used to scan only file a specific file extension. Example: .gif
6794

68-
### 8. Max Threads
95+
#### Max Threads
6996

7097
By default the programs uses the ProcessorCount to determine the maximum threads to use. This options allows the end user to override that option. The minimum value is 4, and the maximum value is 400.
7198

72-
### 9. Max Translation Len
99+
#### Max Translation Len
73100

74101
The translation length is used when the program translates many files in a single translation request. This happens if there are many files (over 100), or if the user selects option to translate many files per request.
75102

76103
This value is set to 10000 by default. The minimum value is 255, and the maximum value is 10,000.
77104

78-
### 10 Files-Per-Translation-Req
105+
#### Files-Per-Translation-Req
79106

80107
This options determines if one file is used per translation request, or if many files are used per translation request. The following are the possible options to select from the combobox window.
81108

@@ -92,37 +119,38 @@ This options determines if one file is used per translation request, or if many
92119
Multiple files are sent per translation request. This is the perferred option if the files are all in either the source language or the target language.
93120

94121

95-
### 11 Target Language
122+
#### Target Language
96123

97124
This setting is an [ISO 639-1](https://wikipedia.org/wiki/List_of_ISO_639-1_codes) two letter code.
98125
By default, the target language is set to the operating system language settings. (CurrentCulture.TwoLetterISOLanguageName)
99126

100127
Use this option to override the target language. See [ISO 639-1](https://wikipedia.org/wiki/List_of_ISO_639-1_codes) link to get desired language code.
101128

102-
### 12 Source Language
129+
#### Source Language
103130

104131
This is empty by default. When this value is empty, the translation works in "Auto" mode, which lets the translator determine the source language.
105132

106133
For most use cases, this value should be left empty. If populated, use [ISO 639-1](https://wikipedia.org/wiki/List_of_ISO_639-1_codes) link to get desired language code.
107134

108-
### 13 Filter
135+
#### Sortable File List
109136

110-
This option allows user to use keywords to find or filter the list to only items having the keyword(s).
137+
The list view has multiple columns, and the list can be sorted by any column by clicking on the column header.
138+
139+
## Option Window Screenshot
111140

112-
When this option is used, and the "Rename All" option is selected, only the resulting filtered items displayed are renamed.
113141

114142
[![Screenshot2](doc/screenshot2.png)](https://github.com/David-Maisonave/TranslateFileNames)
115143

116144
# Console Program
117145

118-
## Command Line Example Usage:
146+
#### Command Line Example Usage:
119147

120148
- TranslateFileNames -r
121149

122150
- TranslateFileNames "C:\Users\jane-doe\Pictures" -r -ext *.jpg
123151

124152

125-
# Authors
153+
# Author
126154

127155
* **David Maisonave** - [David-Maisonave](https://github.com/David-Maisonave)
128156

0 commit comments

Comments
 (0)