Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
David-Maisonave committed Aug 2, 2022
2 parents 6d9c0d3 + c633444 commit 129c0a6
Showing 1 changed file with 47 additions and 19 deletions.
66 changes: 47 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,43 @@
[![Screenshot1](doc/screenshot1.png)](https://github.com/David-Maisonave/TranslateFileNames)

# Translate File Names
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.

## What does it do?

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

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

# Content

[Features](README.md#Features)
- [Translates all file names in folder](README.md#Translates-all-file-names-in-folder)
- [Modify translated name](README.md#Modify-translated-name)
- [Search Recursively](README.md#Search-Recursively)
- [Long Path Support](README.md#Long-Path-Support)
- [Append Original Name](README.md#Append-Original-Name)
- [Append Language Name](README.md#Append-Language-Name)
- [File Type](README.md#File-Type)
- [Max Threads](README.md#Max-Threads)
- [Max Translation Len](README.md#Max-Translation-Len)
- [Files-Per-Translation-Req](README.md#Files-Per-Translation-Req)
- [Target Language](README.md#Target-Language)
- [Source Language](README.md#Source-Language)
- [Filter](README.md#Filter)

[Console Program](README.md#Console-Program)

[Author](README.md#Author)

[License](README.md#License)


# Features
## Features

### 1. Translates all file names in selected folder.
#### Translates all file names in folder

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

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

Renames only files which have not been checked.

#### Filter

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

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

### 2. Modify translated name
#### Modify translated name

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

### 3. Search Recursively
#### Search Recursively

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

### 4. Long Path Support
#### Long Path Support

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

### 5. Append Original Name
#### Append Original Name

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

### 6. Append Language Name
#### Append Language Name

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

### 7. File Type
#### File Type

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

### 8. Max Threads
#### Max Threads

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.

### 9. Max Translation Len
#### Max Translation Len

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.

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

### 10 Files-Per-Translation-Req
#### Files-Per-Translation-Req

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.

Expand All @@ -92,37 +119,38 @@ This options determines if one file is used per translation request, or if many
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.


### 11 Target Language
#### Target Language

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

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.

### 12 Source Language
#### Source Language

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

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.

### 13 Filter
#### Sortable File List

This option allows user to use keywords to find or filter the list to only items having the keyword(s).
The list view has multiple columns, and the list can be sorted by any column by clicking on the column header.

## Option Window Screenshot

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

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

# Console Program

## Command Line Example Usage:
#### Command Line Example Usage:

- TranslateFileNames -r

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


# Authors
# Author

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

Expand Down

0 comments on commit 129c0a6

Please sign in to comment.