mirror of
https://github.com/Tichau/FileConverter.git
synced 2026-11-19 17:12:22 +01:00
287 lines
10 KiB
HTML
287 lines
10 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-us">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<title>File Converter by Tichau</title>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<link rel="stylesheet" type="text/css" href="stylesheets/normalize.css" media="screen">
|
|
<link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
|
|
<link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
|
|
<link rel="stylesheet" type="text/css" href="stylesheets/github-light.css" media="screen">
|
|
|
|
<script>
|
|
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
|
|
|
ga('create', 'UA-71411543-1', 'auto');
|
|
ga('send', 'pageview');
|
|
</script>
|
|
</head>
|
|
<body>
|
|
<section class="page-header">
|
|
<a href="index.html"><img src="images/application-icon.png" height="128" width="128" /></a>
|
|
<h1 class="project-name">File Converter documentation</h1>
|
|
<a href="index.html" class="btn">Back</a>
|
|
<a href="download.html" class="btn">Download (64 bits)</a>
|
|
<a href="https://github.com/Tichau/FileConverter" class="btn">View on GitHub</a>
|
|
<a href="https://github.com/Tichau/FileConverter/tarball/master" class="btn">Sources</a>
|
|
</section>
|
|
|
|
<section class="main-content">
|
|
<h2>
|
|
<a id="description" class="anchor" href="#description" aria-hidden="true"><span class="octicon octicon-link"></span></a>
|
|
Description
|
|
</h2>
|
|
|
|
<p><strong>File Converter</strong> 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.</p>
|
|
|
|
<p>This application is under GPL version 3 licence.
|
|
For more informations check the LICENSE file in your installation folder or the <a href="http://www.gnu.org/licenses/gpl.html">gnu website</a>.</p>
|
|
|
|
<h2>
|
|
<a id="supported-file-formats" class="anchor" href="#supported-file-formats" aria-hidden="true"><span class="octicon octicon-link"></span></a>
|
|
Supported file formats
|
|
</h2>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Category</th>
|
|
<th>Supported output formats</th>
|
|
<th>Compatible input formats</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>Audio</td>
|
|
<td>FLAC, AAC, OGG, MP3, WAV</td>
|
|
<td>aiff, ape, avi, bik, cda, flac, flv, m4a, mkv, mov, mp3, mp4, ogg, wav, wma</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Video</td>
|
|
<td>MKV</td>
|
|
<td>avi, bik, flv, mkv, mov</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Image</td>
|
|
<td>PNG, JPG, ICO</td>
|
|
<td>bmp, ico, jpg, jpeg, png, tiff</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p><em>Note: If your source file is a video, the conversion to an audio format will extract the audio part of the video.</em></p>
|
|
<p><em>Note 2: The mkv output file format encodes video using H.264 encoder for video and AAC encoder for audio.</em></p>
|
|
|
|
<h2>
|
|
<a id="input-file-post-conversion-actions" class="anchor" href="#input-file-post-conversion-actions" aria-hidden="true"><span class="octicon octicon-link"></span></a>Input file post conversion actions</h2>
|
|
|
|
<p>This actions allow you to chose what you want to do with your input files if the conversion succeed.</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Action</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><strong>None</strong></td>
|
|
<td>Don't modify the input file. If the output file name conflict with the input, it will be renamed.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>Move in archive folder</strong></td>
|
|
<td>Move the input file in a folder named <em>Conversion Archives</em> if the conversion is a success.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>Delete</strong></td>
|
|
<td>Delete the input file if the conversion is a success (be careful no warning will be prompted).</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h2>
|
|
<a id="output-file-path-template" class="anchor" href="#output-file-path-template" aria-hidden="true"><span class="octicon octicon-link"></span></a>Output file path template</h2>
|
|
|
|
<p>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:</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Pattern</th>
|
|
<th>Description</th>
|
|
<th>Example (with input path: <em>C:\Music\Artist\Album\Song.wav</em>)</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>(p)</td>
|
|
<td>Input file path</td>
|
|
<td>C:\Music\Artist\Album\</td>
|
|
</tr>
|
|
<td>(p:d)</td>
|
|
<td>My documents folder path</td>
|
|
<td>C:\Users\UserName\Documents\</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(p:m)</td>
|
|
<td>My music folder path</td>
|
|
<td>C:\Users\UserName\Music\</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(p:v)</td>
|
|
<td>My videos folder path</td>
|
|
<td>C:\Users\UserName\Videos\</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(p:p)</td>
|
|
<td>My pictures path</td>
|
|
<td>C:\Users\UserName\Pictures\</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(f)</td>
|
|
<td>Input file name</td>
|
|
<td>Song</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(o)</td>
|
|
<td>Output file format</td>
|
|
<td>mp3</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(i)</td>
|
|
<td>Input file format</td>
|
|
<td>wav</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(d0)</td>
|
|
<td>Input parent folder name</td>
|
|
<td>Album</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(d1)</td>
|
|
<td>Input sub parent folder name</td>
|
|
<td>Artist</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<p>*Tips: You can use uppercase to retrieve caps lock informations. Example: (f) -> Default / (F) -> DEFAULT *</p>
|
|
|
|
<h3>
|
|
<a id="examples" class="anchor" href="#examples" aria-hidden="true"><span class="octicon octicon-link"></span></a>Examples</h3>
|
|
|
|
<p>Simple default template (just change the extension): </p>
|
|
|
|
<pre><code>Input: C:\Music\Artist\Album\Song.wav
|
|
Template: (p)(f)
|
|
Generated output: C:\Music\Artist\Album\Song.mp3
|
|
</code></pre>
|
|
|
|
<p>File name customization:</p>
|
|
|
|
<pre><code>Input: C:\Music\Artist\Album\Song.wav
|
|
Template: (p)(O)_(f) (from (i))
|
|
Generated output: C:\Music\Artist\Album\MP3_Song (from wav).mp3
|
|
</code></pre>
|
|
|
|
<p>File path customization:</p>
|
|
|
|
<pre><code>Input: C:\Music\Artist\Album\Song.wav
|
|
Template: D:\(o)\(d1)\(f)
|
|
Generated output: D:\mp3\Artist\Song.mp3
|
|
</code></pre>
|
|
|
|
<p>CDA extraction:</p>
|
|
|
|
<pre><code>Input: E:\Track01.cda
|
|
Template: (p:m)CDA Extraction\(f)
|
|
Generated output: C:\Users\UserName\Music\CDA Extraction\Track01.mp3
|
|
</code></pre>
|
|
|
|
<h2>
|
|
<a id="thanks" class="anchor" href="#thanks" aria-hidden="true"><span class="octicon octicon-link"></span></a>
|
|
Thanks
|
|
</h2>
|
|
<p>File converter uses the following middlewares:</p>
|
|
|
|
<p><strong>ffmpeg</strong> as file conversion software.
|
|
Thanks to ffmpeg devs for this awesome open source file convesion tool. <a href="https://www.ffmpeg.org/">Web site link</a></p>
|
|
|
|
<p><strong>SharpShell</strong> to easily create windows context menu extensions.
|
|
Thanks to Dave Kerr for his work on SharpShell. <a href="https://sharpshell.codeplex.com/">CodePlex link</a></p>
|
|
|
|
<p><strong>Ripper</strong> and <strong>yeti.mmedia</strong> for CD Audio extraction.
|
|
Thanks to Idael Cardoso for his work on CD Audio ripper. <a href="http://www.codeproject.com/Articles/5458/C-Sharp-Ripper">Code project link</a></p>
|
|
|
|
<h2>
|
|
<a id="change-log" class="anchor" href="#change-log" aria-hidden="true"><span class="octicon octicon-link"></span></a>Change Log</h2>
|
|
|
|
<h3>v0.4</h3>
|
|
<ul>
|
|
<li>New: Possibility to encode videos (mkv output file format) using H.264 video codec and AAC audio codec.</li>
|
|
<li>New: Possibility to extract Audio CD content.</li>
|
|
<li>New: Possibility to encode audio in aac format.</li>
|
|
<li>New: Possibility to encode images (png, jpg and ico formats).</li>
|
|
<li>New: Support new audio input file format: aac</li>
|
|
<li>New: Support new video input file formats: bik, flv, mov, mkv</li>
|
|
<li>New: Support new image input file formats: bmp, tiff, png, jpg and ico.</li>
|
|
<li>New: Multi-thread conversion (file converter will now start multiple conversions at the time depending on your number of cores).</li>
|
|
<li>New: Copy the currently selected preset when clicking on the add preset button.</li>
|
|
<li>New: Add “My Documents”, “My Music”, “My Videos” and “My Pictures” folder to output file name generator.</li>
|
|
<li>New: Possibily to chose if the application quit after succeeded conversions.</li>
|
|
<li>Fixed: Reordering presets does not update the registry.</li>
|
|
<li>Tech: Handle incorrect user settings case.</li>
|
|
<li>Tech: Improve diagnostics system (compatibility with logs from multiple threads, dump files in AppData folder and error messages).</li>
|
|
<li>Tech: Update ffmpeg version.</li>
|
|
</ul>
|
|
|
|
<h3>v0.3</h3>
|
|
|
|
<ul>
|
|
<li>New: Possibility to extract audio from videos.</li>
|
|
<li>New: Support new input file formats: aiff, m4a, avi, mp4.</li>
|
|
<li>New: Quality settings for Mp3 (Encoding mode vbr/cbr and bitrate).</li>
|
|
<li>New: Quality settings for Ogg (Bitrate).</li>
|
|
<li>New: Quality settings for Wav (bits per sample: 8, 16, 24 or 32).</li>
|
|
<li>New: Add output file path template system.</li>
|
|
<li>New: Add button to move up or down a preset.</li>
|
|
<li>New: Add input files post conversion action (No action, move in archive folder or delete).</li>
|
|
<li>New: Add categories on input file extensions.</li>
|
|
<li>Fixed: Lose focus of main window don't terminate the application.</li>
|
|
<li>Fixed: The application icon now have a correct resolution at any size.</li>
|
|
<li>Tech: Add error codes on error messages.</li>
|
|
</ul>
|
|
|
|
<h3>v0.2</h3>
|
|
|
|
<ul>
|
|
<li>New: Support new input file format: ape.</li>
|
|
<li>New: Add notion of conversion preset (in order to customize the conversion possibilities).</li>
|
|
<li>New: Add settings window to edit conversion presets.</li>
|
|
<li>New: Add application icon.</li>
|
|
<li>New: Customize application installer.</li>
|
|
<li>New: Add diagnostic window to read the application logs.</li>
|
|
</ul>
|
|
|
|
<h3>v0.1</h3>
|
|
|
|
<ul>
|
|
<li>New: Add decode support for file formats Mp3, Ogg, Wav, Flac, Wma </li>
|
|
<li>New: Add encode support for file formats Mp3, Ogg, Wav, Flac</li>
|
|
<li>New: UI to visualize the conversion progress</li>
|
|
</ul>
|
|
|
|
<footer class="site-footer">
|
|
<span class="site-footer-owner"><a href="https://github.com/Tichau/FileConverter">File Converter</a> is maintained by <a href="https://github.com/Tichau">Tichau</a>.</span>
|
|
|
|
<span class="site-footer-credits">This page was generated by <a href="https://pages.github.com">GitHub Pages</a> using the <a href="https://github.com/jasonlong/cayman-theme">Cayman theme</a> by <a href="https://twitter.com/jasonlong">Jason Long</a>.</span>
|
|
</footer>
|
|
|
|
</section>
|
|
|
|
</body>
|
|
</html>
|