Split readme file

Add changelog.md and licence.md
This commit is contained in:
Tichau 2015-12-21 22:25:41 +01:00
parent 1d64c778e7
commit 4f38accc9e
4 changed files with 61 additions and 109 deletions

45
CHANGELOG.md Normal file
View File

@ -0,0 +1,45 @@
# Change Log
## Version 0.4
- New: Possibility to encode videos (mkv output file format) using H.264 video codec and AAC audio codec.
- New: Possibility to extract Audio CD content.
- New: Possibility to encode audio in aac format.
- New: Possibility to encode images (png, jpg and ico formats).
- New: Support new audio input file format: aac
- New: Support new video input file formats: bik, flv, mov, mkv
- New: Support new image input file formats: bmp, tiff, png, jpg and ico.
- New: Multi-thread conversion (file converter will now start multiple conversions at the time depending on your number of cores).
- New: Copy the currently selected preset when clicking on the add preset button.
- New: Add "My Documents", "My Music", "My Videos" and "My Pictures" folder to output file name generator.
- New: Possibily to chose if the application quit after succeeded conversions.
- Fixed: Reordering presets does not update the registry.
- Tech: Handle incorrect user settings case.
- Tech: Improve diagnostics system (compatibility with logs from multiple threads, dump files in AppData folder and error messages).
- Tech: Update ffmpeg version.
## Version 0.3
- New: Possibility to extract audio from videos.
- New: Support new input file formats: aiff, m4a, avi, mp4.
- New: Quality settings for Mp3 (Encoding mode vbr/cbr and bitrate).
- New: Quality settings for Ogg (Bitrate).
- New: Quality settings for Wav (bits per sample: 8, 16, 24 or 32).
- New: Add output file path template system.
- New: Add button to move up or down a preset.
- New: Add input files post conversion action (No action, move in archive folder or delete).
- New: Add categories on input file extensions.
- Fixed: Lose focus of main window don't terminate the application.
- Fixed: The application icon now have a correct resolution at any size.
- Tech: Add error codes on error messages.
## Version 0.2
- New: Support new input file format: ape.
- New: Add notion of conversion preset (in order to customize the conversion possibilities).
- New: Add settings window to edit conversion presets.
- New: Add application icon.
- New: Customize application installer.
- New: Add diagnostic window to read the application logs.
## Version 0.1
- New: Add decode support for file formats Mp3, Ogg, Wav, Flac, Wma
- New: Add encode support for file formats Mp3, Ogg, Wav, Flac
- New: UI to visualize the conversion progress

View File

@ -68,6 +68,12 @@
<Component Guid="{A5158756-A107-4010-9E2F-3C0333F5A5F6}" Win64="$(var.Win64)"> <Component Guid="{A5158756-A107-4010-9E2F-3C0333F5A5F6}" Win64="$(var.Win64)">
<File Source="..\README.md" KeyPath="yes" /> <File Source="..\README.md" KeyPath="yes" />
</Component> </Component>
<Component Guid="{B57DCB2B-3520-4430-98CB-41B58F530D75}" Win64="$(var.Win64)">
<File Source="..\CHANGELOG.md" KeyPath="yes" />
</Component>
<Component Guid="{6378238B-E44F-414B-A7AE-7E72CFA8616D}" Win64="$(var.Win64)">
<File Source="..\LICENSE.md" KeyPath="yes" />
</Component>
<Component Guid="{55CD0B47-D5B0-4F0C-A54E-3E11DF345B48}" Win64="$(var.Win64)"> <Component Guid="{55CD0B47-D5B0-4F0C-A54E-3E11DF345B48}" Win64="$(var.Win64)">
<File Id="Ripper.dll" KeyPath="yes" Source="..\Middleware\Ripper.dll" /> <File Id="Ripper.dll" KeyPath="yes" Source="..\Middleware\Ripper.dll" />
</Component> </Component>

View File

@ -1,11 +1,11 @@
GNU GENERAL PUBLIC LICENSE # GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007 ## Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed. of this license document, but changing it is not allowed.
Preamble ## Preamble
The GNU General Public License is a free, copyleft license for The GNU General Public License is a free, copyleft license for
software and other kinds of works. software and other kinds of works.
@ -68,7 +68,7 @@ patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and The precise terms and conditions for copying, distribution and
modification follow. modification follow.
TERMS AND CONDITIONS ## TERMS AND CONDITIONS
0. Definitions. 0. Definitions.
@ -618,9 +618,9 @@ an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee. copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS ## END OF TERMS AND CONDITIONS
----
How to Apply These Terms to Your New Programs ## How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it possible use to the public, the best way to achieve this is to make it

105
README.md
View File

@ -3,9 +3,6 @@
## Description ## Description
**File Converter** is a very simple tool which allows you to convert one or several file(s) from one format to another using the context menu in windows explorer. **File Converter** is a very simple tool which allows you to convert one or several file(s) from one format to another using the context menu in windows explorer.
This application is under GPL version 3 licence.
For more informations check the LICENSE file in your installation folder or the [gnu website](http://www.gnu.org/licenses/gpl.html).
You can download it here: [www.file-converter.org](http://file-converter.org). You can download it here: [www.file-converter.org](http://file-converter.org).
## Supported file formats ## Supported file formats
@ -20,62 +17,6 @@ Category | Supported output formats | Compatible input formats
*Note 2: The mkv output file format encodes video using H.264 encoder for video and AAC encoder for audio.* *Note 2: The mkv output file format encodes video using H.264 encoder for video and AAC encoder for audio.*
## Input file post conversion actions
This actions allow you to chose what you want to do with your input files if the conversion succeed.
Action | Description
----------------------------|------------------------------------------------------------------------------------------------
**None** | Don't modify the input file. If the output file name conflict with the input, it will be renamed.
**Move in archive folder** | Move the input file in a folder named *Conversion Archives* if the conversion is a success.
**Delete** | Delete the input file if the conversion is a success (be careful no warning will be prompted).
## Output file path template
This template allow you to define how you want to generate the output file path (depending on the input file path).
You have access to the following informations:
Pattern | Description | Example (with input path: *C:\Music\Artist\Album\Song.wav*)
--------|-------------------------------|-----------------------------------------------------------------
(p) | Input file path | C:\Music\Artist\Album\
(p:d) | My documents folder path | C:\Users\UserName\Documents\
(p:m) | My music folder path | C:\Users\UserName\Music\
(p:v) | My videos folder path | C:\Users\UserName\Videos\
(p:p) | My pictures path | C:\Users\UserName\Pictures\
(f) | Input file name | Song
(o) | Output file format | mp3
(i) | Input file format | wav
(d0) | Input parent folder name | Album
(d1) | Input sub parent folder name | Artist
*Tips: You can use uppercase to retrieve caps lock informations. Example: (f) -> Default / (F) -> DEFAULT *
### Examples
Simple default template (just change the extension):
Input: C:\Music\Artist\Album\Song.wav
Template: (p)(f)
Generated output: C:\Music\Artist\Album\Song.mp3
File name customization:
Input: C:\Music\Artist\Album\Song.wav
Template: (p)(O)_(f) (from (i))
Generated output: C:\Music\Artist\Album\MP3_Song (from wav).mp3
File path customization:
Input: C:\Music\Artist\Album\Song.wav
Template: D:\(o)\(d1)\(f)
Generated output: D:\mp3\Artist\Song.mp3
CDA extraction:
Input: E:\Track01.cda
Template: (p:m)CDA Extraction\(f)
Generated output: C:\Users\UserName\Music\CDA Extraction\Track01.mp3
## Thanks ## Thanks
File converter uses the following middlewares: File converter uses the following middlewares:
@ -89,47 +30,7 @@ Thanks to Dave Kerr for his work on SharpShell. [CodePlex link](https://sharpshe
**Ripper** and **yeti.mmedia** for CD Audio extraction. **Ripper** and **yeti.mmedia** for CD Audio extraction.
Thanks to Idael Cardoso for his work on CD Audio ripper. [Code project link](http://www.codeproject.com/Articles/5458/C-Sharp-Ripper) Thanks to Idael Cardoso for his work on CD Audio ripper. [Code project link](http://www.codeproject.com/Articles/5458/C-Sharp-Ripper)
## Change Log ## License
### v0.4
- New: Possibility to encode videos (mkv output file format) using H.264 video codec and AAC audio codec.
- New: Possibility to extract Audio CD content.
- New: Possibility to encode audio in aac format.
- New: Possibility to encode images (png, jpg and ico formats).
- New: Support new audio input file format: aac
- New: Support new video input file formats: bik, flv, mov, mkv
- New: Support new image input file formats: bmp, tiff, png, jpg and ico.
- New: Multi-thread conversion (file converter will now start multiple conversions at the time depending on your number of cores).
- New: Copy the currently selected preset when clicking on the add preset button.
- New: Add "My Documents", "My Music", "My Videos" and "My Pictures" folder to output file name generator.
- New: Possibily to chose if the application quit after succeeded conversions.
- Fixed: Reordering presets does not update the registry.
- Tech: Handle incorrect user settings case.
- Tech: Improve diagnostics system (compatibility with logs from multiple threads, dump files in AppData folder and error messages).
- Tech: Update ffmpeg version.
### v0.3 File Converter is licensed under the GPL version 3 License.
- New: Possibility to extract audio from videos. For more informations check the LICENSE.md file in your installation folder or the [gnu website](http://www.gnu.org/licenses/gpl.html).
- New: Support new input file formats: aiff, m4a, avi, mp4.
- New: Quality settings for Mp3 (Encoding mode vbr/cbr and bitrate).
- New: Quality settings for Ogg (Bitrate).
- New: Quality settings for Wav (bits per sample: 8, 16, 24 or 32).
- New: Add output file path template system.
- New: Add button to move up or down a preset.
- New: Add input files post conversion action (No action, move in archive folder or delete).
- New: Add categories on input file extensions.
- Fixed: Lose focus of main window don't terminate the application.
- Fixed: The application icon now have a correct resolution at any size.
- Tech: Add error codes on error messages.
### v0.2
- New: Support new input file format: ape.
- New: Add notion of conversion preset (in order to customize the conversion possibilities).
- New: Add settings window to edit conversion presets.
- New: Add application icon.
- New: Customize application installer.
- New: Add diagnostic window to read the application logs.
### v0.1
- New: Add decode support for file formats Mp3, Ogg, Wav, Flac, Wma
- New: Add encode support for file formats Mp3, Ogg, Wav, Flac
- New: UI to visualize the conversion progress