Skip to content

Commit

Permalink
Fix issues for V6.2.7 #197
Browse files Browse the repository at this point in the history
  • Loading branch information
FrankBijnen committed Dec 13, 2023
1 parent 939d0ca commit 3e37266
Show file tree
Hide file tree
Showing 10 changed files with 61 additions and 116 deletions.
58 changes: 28 additions & 30 deletions Docs/ExifToolGUI_V6.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@
<h1>ExifToolGUI for Windows v6.xx</h1><hr>
<h2>Introduction</h2>
In the summer of 2023 I decided to revive the ExifToolGui project initally created by <b>Bogdan Hrastnik</b>.
This revival resulted in <b>Version 6</b><br>
Read his complete documentation <a href="https://htmlpreview.github.io/?https://github.com/FrankBijnen/ExifToolGui/blob/Development/Docs/Original%20notes/ExifToolGUI_V516.htm"><b>here</b></a><br><br>
This was his intro, I will quote it now, because it still holds for me:<br><br>
<em>
Expand All @@ -28,7 +27,7 @@ The only downside for many potential users is the fact, that ExifTool is
(GUI), so all work must be done by typing commands inside "Command
Prompt" window. Such approach gives ExifTool great flexibility, but is
somehow difficult to use -especially for those, who don't use ExifTool
regularly.<br>
regulary.<br>
<br>

So, I've decided to make some simple ExifTool GUI for my private use.
Expand Down Expand Up @@ -57,20 +56,15 @@ Basic idea behind GUI is, to keep it <u>simple!</u> Thus, only those options are
<li>Better support for international characters. All internal code now uses Unicode (UTF16), to interface with Exiftool UTF8.</li>
<li>Enhanced Log Window. The last 10 commands are shown, with their respective output and error. Option to replay the command in PowerShell/Cmd prompt.</li>
<li>The external programs Jhead.exe and Jpegtran.exe are no longer needed. Rotation, and cropping, are handled in Delphi native code. With a modified library called NativeJpg by SimDesign B.V. (I tried contacting SimDesign to verify the Licence requirements, but was unable to.)</li>
<li>Exporting and Importing previews has been revised, and offer greater flexibility.</li>
<li>Exporting and Importing previews has been revised, and offer greater flexability.</li>
<li>GeoCoding has been enhanced. You can now choose from 2 providers (https://overpass-api.de and https://geocode.maps.co) and lookup City, Province and Country from GPS coordinates AKA reverse GeoCoding.</li>
<li>Option added to show folders in the FileList panel.</li>
<li>Possibility to add Custom options to Exiftool.</li>
<li>Experimental support for <a href="Readme%204K%20monitor.txt"><b>4K monitors.</b></a></li>
</ul>
<a href="changelog.txt"><b>See changelog.txt for a complete list of issues.</b></a>

<a name="m_reqs_general">
<h2>Requirements and preparations</h2>
ExiftoolGUI should run on Windows 7, 8 32-64bit. However, it is highly recommended to use Windows 10 or 11 when you plan to use the OSM map, or GEOcoding.<br>
It will not run on Windows XP or earlier!<br>

<a name="m_reqs_exiftool">
<h3>1. ExifTool</h3>
You only need to download the "Windows Executable" zip file from <a href="https://exiftool.org/"><b>here</b></a>.
After unzipping, depending on your Windows Explorer settings, you will see:<font color="CC0000">exiftool(-k)</font> or <font color="CC0000">exiftool(-k).exe</font>
Expand All @@ -86,7 +80,7 @@ If you want Windows to be able to always find ExifTool, then add the directory w
<li>In case you've done something wrong in this regard, you'll see an error message when GUI starts.</li>
</ul>

<h3><a name="m_reqs_exiftoolgui">2. ExifToolGUI</h3>
<h3>2. ExifToolGUI</h3>
You can download GUI from <a href="https://github.com/FrankBijnen/ExifToolGui/releases"><b>here</b></a>.
GUI doesn't need to be "installed". Just download the executable for your platform (ExifToolGui.exe or ExifToolGui_X64.exe) into any directory, create a Desktop shortcut and GUI is ready to use.<br>
<br>
Expand All @@ -104,7 +98,7 @@ It was decided not to save the INI file in the same directory as the executable,
</li>
</ul>

<h3><a name="m_reqs_exiftoolgui"><a name="m_edge">3. Edge browser needed for OSM map<a></h3>
<h3><a name="m_edge">3. Edge browser needed for OSM map<a></h3>
If you don't need the OSM map functionality, you can skip this step.<br>
The OSM map is hosted by an internal web browser based on Edge. There are 2 requirements. The <b>Edge Runtime</b> and the <b>WebView2Loader.dll</b>.

Expand Down Expand Up @@ -133,14 +127,15 @@ Extract the file 'runtimes\win-x86\native\WebView2Loader.dll' or 'runtimes\win-x
<a href="https://docwiki.embarcadero.com/RADStudio/Sydney/en/Using_TEdgeBrowser_Component_and_Changes_to_the_TWebBrowser_Component">More info for developers from Embarcadero</a>
<br>

<h3>4. Wish to see thumbnails of raw image files?</h3>
<h3>4. jhead.exe &amp; jpegtran.exe</h3>
These files are no longer needed, but can still be used if available.<br>
The menu-items that use these programs are marked <u>deprecated</u> and will be removed in a next release.</br>

<h3>5. Wish to see thumbnails of raw image files?</h3>
Of course you do. What you need is a "raw codec", usually available for free from the camera manufacturer.
The best I've found so far is "FastPictureViewer codec" (from <a href="http://www.fastpictureviewer.com/codecs/">here</a>).
It is very fast, covers many raw formats and is free for personal use.<br>
<a href="Readme Using Codecs.txt"><b>Readme Using Codecs.txt</b></a>

<h3>5. jhead.exe &amp; jpegtran.exe</h3>
These files are no longer needed.<br>
<br>
<br>

Expand Down Expand Up @@ -254,13 +249,7 @@ If you check this, double-clicking in the Workspace will remove a tag,
double-clicking on one of the tabs Exif, Xmp, Iptc, Maker, All will add that tag to the Workspace.
<br><br>
<b>Exiftool.exe location</b><br>
If you need to override the location of exiftool.exe you can do that here.<br><br>
<b>Filelist: Show Folders in Filelist</b><br>
The default setting is to only show files in the Filelist panel. If you enable this option, also folders (directories) will be shown, allowing easier navigation.<br>
It will also enable a BreadCrumb bar.<br><br>
<b>Hint pause timeout in Millisecs</b><br>
Hovering over the metadata panel will display the complete metadata value as a hint. This was added because long values are often not completely visible.<br>
Setting this value to 0 (zero) will effectively disable the hints.
If you need to override the location of exiftool.exe you can do that here.
<br><br>

<h3><a name="m_workspace">Workspace manager</a></h3>
Expand Down Expand Up @@ -402,10 +391,7 @@ next GUI start. Remaining options settings however, are only temporary

<h3>Group tag names by instance (-g4)</h3></font> -This can help you to identify duplicated tags when viewing in <font class="blue">Metadata</font> panel.<br>

<h3>API WindowsWideFile (requires Exiftool v12.66)</h3> -Force the use of wide-character Windows I/O functions when the CharsetFileName option is used.<br>

<h3>Custom options</h3> -You can specify additonal options that exiftool should use. Expert option. Normally used with the Log Window.<br>
Possible use case is the option <b>-htmldump</b> and use the log window to catch the output.<br>
<h3>API WindowsWideFile (requires Exiftool v12.66)</h3></font> -Force the use of wide-character Windows I/O functions when the CharsetFileName option is used.<br>
<br>
<br>
<h2><a name="m_exp_imp">Export/Import menu</a></h2>
Expand Down Expand Up @@ -554,6 +540,16 @@ cases, that will be the same folder where image files reside.</li>
...and that's it.<br>
<br>

<h3>Extract preview image from selected: raw files (Deprecated)</h3>
This function has been replaced by <b>Generic extract previews</b> and will be
removed in a next release.
<br>

<h3>Embed preview image into selected: raw files (Deprecated)</h3>
This function has been replaced by <b>Generic import preview</b> and will be
removed in a next release.
<br>

<h3>Generic extract previews</h3>
As you may know raw image files can also contain a JPG image, which serves for
previewing raw image file content. In most cases, this JPG image is "as
Expand Down Expand Up @@ -626,6 +622,11 @@ If you have a backup tool that relies on the Date Modified, it will not notice t
<img src="ExifToolGUI_V6_files/renamefiles.jpg"><br>
<br>

<h3>JPG: Lossless autorotate (Deprecated)</h3>
This menu still uses external program jhead.exe. (if available) But will be removed in a next release. Use the next menu-item.<br>
<br>
<br>

<h3>JPG: Lossless autorotate + crop</h3>
This will physically rotate selected JPG images according to Exif:Orientation value inside files.<br>
It uses a library NativeJpg by SimDesign B.V. to do the actual rotating. No external program is needed.<br>
Expand Down Expand Up @@ -660,9 +661,7 @@ appropriate raw "codec", to be able to see thumbnails and previews.<br>
<br>

<b>Details</b> drop-down box<br>
-is set to <font class="blue">Standard filelist</font> by default. This drop-down box also contain few predefined details views:<br>
<font class="blue">Camera settings, Location info</font> and <font class="blue">About photo</font> -where each of these views shows few metadata values inside files; i.e.:<br>
<u><b>Note:</b></u> The Folders and the Breadcrumb bar are shown only when enabled in Preferences/Other.<br>
-is set to <font class="blue">Standard filelist</font> by default. This drop-down box also contain few predefined details views: <font class="blue">Camera settings, Location info</font> and <font class="blue">About photo</font> -where each of these views shows few metadata values inside files; i.e.:<br>
<img src="ExifToolGUI_V6_files/filelistcamerasettings.jpg"><br>
<br>

Expand Down Expand Up @@ -996,15 +995,14 @@ P.S.: Don't blame me for my English grammar -it's not my native language.<br>
</em>
<br>
Frank<br>
Modified on December, 2023<br>
Modified on November, 2023<br>
<br>

<u>You may find additional info in the ReadMe files:</u>
<ul>
<li><a href="ReadMe for Developers.txt">ReadMe for Developers</a></li>
<li><a href="..\Source\Vcl.ShellControls\ReadMe.txt">ReadMe ShellControls</a></li>
<li><a href="..\Source\NativeJpg\README.txt">ReadMe NativeJpg</a></li>
<li><a href="..\Source\BeadcrumbBar\README.txt">ReadMe Breaddcrum Bar</a></li>
<li><a href="ReadMe for Users.txt">ReadMe for Users</a></li>
<li><a href="Readme GeoCoding.txt">Readme GeoCoding</a></li>
<li><a href="Readme Long filenames.txt">Readme Long filenames</a></li>
Expand Down
Binary file added Docs/ExifToolGUI_V6_files/Thumbs.db
Binary file not shown.
Binary file modified Docs/ExifToolGUI_V6_files/filelistcamerasettings.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Docs/ExifToolGUI_V6_files/gui_screen.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Docs/ExifToolGUI_V6_files/preferences_other.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 0 additions & 6 deletions Docs/ReadMe for Developers.txt
Original file line number Diff line number Diff line change
Expand Up @@ -68,11 +68,5 @@ Surely this is not the end....
A few new units, and forms were added.

And various fixes like: generating Thumbnails, selecting a directory while the shelllist is sorted, etc. See also: https://github.com/FrankBijnen/ExifToolGui/issues/118

Version 6.2.7.

Option to add folders (Directories) to the filelist. If enabled also the control BreadCrumbBar by Andreas Rejbrand, is instantiated.
You can find the source in the subdirectory BreadbrumbBar.
Added experimental support for 4K monitors. See UnitScaleForm.pas

Frank
14 changes: 0 additions & 14 deletions Docs/ReadMe for Users.txt
Original file line number Diff line number Diff line change
Expand Up @@ -98,18 +98,4 @@ Changed with version 6.2.5
- Various small fixes, for bugs encountered when testing.
If you find a bug, or think you found one, dont hesitate to report. You can create an issue on Github (https://github.com/FrankBijnen/ExifToolGui/issues) or post on the ExifTool forum (https://exiftool.org/forum/index.php?board=7.0).

Changed with version 6.2.6
- The documentation has been updated to reflect the changes from V516 to V626. You can access it from the program via 'Help/Online documentation', or by using this link:
https://htmlpreview.github.io/?https://github.com/FrankBijnen/ExifToolGui/blob/main/Docs/ExifToolGUI_V6.md

Changed with version 6.2.7
- Added the option to show folders in the filelist. If you enable it in Preferences/other als a Breadcrumb is shown. No Metadata/Image functions are available.
It only serves easier navigation.
- Some fixes for styles were applied. Especially the style 'Green' was updated, it had some colours wrongly defined and the caption bar was ugly.
- Added a hint window for the metadata values. It can be disabled in Prefrences/Other by setting the timeout value to 0.
- Added the option to add Custom Options to Exiftool. Not needed for Normal usage.
If you want to experiment: Add the option '-htmldump'. (without the quotes) Open the log window, and check 'Show all commands'. Select any file.
Dont forget to remove the option afterwards!
- Fixed an error message in the generated Powershell script. It would always show the error 'Native Command Error'.

Frank
47 changes: 0 additions & 47 deletions Docs/Readme 4K monitor.txt

This file was deleted.

1 change: 0 additions & 1 deletion Docs/changelog.txt
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,3 @@ Version: Description Issue
Fix Issue #189 Style fixes for Green
Fix Issue #191 Add Custom options
Fix Issue #195 Add Breadcrumb bar. If folders are allowed to show
Fix Issue #199 Experimental support for 4K monitors
51 changes: 33 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,41 @@
# ExifToolGui
<h4>A GUI for ExifTool</h4>
A GUI for ExifTool

Current version: <b>V6.2.6</b> updated November 25, 2023.
Just a few small fixes. And some typos found when updating the docs.
[Online documentation available](https://htmlpreview.github.io/?https://github.com/FrankBijnen/ExifToolGui/blob/main/Docs/ExifToolGUI_V6.md)

Previous version: <b>V6.2.5</b> updated November 12, 2023.
The V6.2.5 release features 2 major changes.<br>
1) [GeoCoding](/Docs/Readme%20GeoCoding.txt) You can now choose from 2 GeoCoding providers, and use Reverse GeoCoding to lookup Country, Province and City from GPS coordinates.<br>
2) [Lossless rotate and crop, import and export previews](/Docs/Readme%20Lossless%20rotate_Import_Export%20previews.txt) The external programs Jhead and JpegTrans are replaced by native Delphi code, using a modified library NativeJpg by SimDesign B.V. Exporting and Importing previews has been revised.<br>

Besides these 2 updates, some smaller updates/bugfixes were applied. See the [ChangeLog](Docs/changelog.txt) for more info.

I have noticed that recently ExifToolGui is downloaded from sites that propagate portable use. Please read [Portable use](/Docs/Readme%20Portable.txt) for more info.

Important: <br>
To help Bug hunting there are also Map files released. If you place the Map file in the same directory as the Executable
a stacktrace can be copied to the clipboard if an Exception occurs. Please also provide the stacktrace if you report an Exception.

This is an updated version of the ExifToolGui program created by Bogdan Hrastnik. Many thanks go out to him.

Current version: <b>V6.2.7</b> updated December 25, 2023.<br>
- Added peek preview for metadata panel. Shown as hint.<br>
- Added option to show Folders in filelist, including a Breadcrumb Bar.<br>
- Added option to add custom tags to Exiftool.<br>
- Fix for generated Powershell script.<br>
- Style fixes for Green.<br>
- Experimental support for [4K Monitors](Docs/Readme%204K%20monitor.txt).<br>
This updated source addresses the following issues.

[Change log](Docs/changelog.txt)<br>
[Download Release](https://github.com/FrankBijnen/ExifToolGui/releases/latest)<br>
1) Compiles with Delphi Community Edition. Without any 3rd party libraries.
2) Added styles.
3) Image preview is done with WIC. The autorotate should be available for more formats then just JPG
4) The Google Map is replaced by OSM map. The internal browser is now based on Edge, and not on IE.

<h4>Important</h4>
To achieve this the source had to be modified quite a lot. Dont expect a flawless product.

- [Please <b>read</b> the Requirements and preparation](https://github.com/FrankBijnen/ExifToolGui/blob/main/Docs/ExifToolGUI_V6.md/#m_reqs_general)<br>
- To help Bug hunting there are also Map files released. If you place the Map file in the same directory as the Executable
a stacktrace can be copied to the clipboard if an Exception occurs. Please also provide the stacktrace if you report an Exception.<br>
See also:
- [Readme for Users](Docs/ReadMe%20for%20Users.txt)
- [Docs directory](Docs/)

# Useful links

<h4>Obtaining Exiftool</h4>
<h4>Obtaining Exiftool.</h4>

1) The original version by Phil Harvey. https://exiftool.org/ <br>
Download the zip file called: Windows Executable: exiftool-xx.yy.zip. <br>
Expand All @@ -31,14 +44,16 @@ a stacktrace can be copied to the clipboard if an Exception occurs. Please also

2) An installer provided by Oliver Betz. https://oliverbetz.de/pages/Artikel/ExifTool-for-Windows

<h4>Obtaining WebWiew2Loader.dll</h4>
<h4>Obtaining WebWiew2Loader.dll.</h4>

- https://nuget.info/packages/Microsoft.Web.WebView2/
- See [Readme for Users](Docs/ReadMe%20for%20Users.txt) for more info.

<h4>Online Documentation</h4>
<h4>Online Documentation.</h4>

- [V516 Documentation html](https://htmlpreview.github.io/?https://github.com/FrankBijnen/ExifToolGui/blob/main/Docs/Original%20notes/ExifToolGUI_V516.htm)

- [V6 Documentation html](https://htmlpreview.github.io/?https://github.com/FrankBijnen/ExifToolGui/blob/main/Docs/ExifToolGUI_V6.md)
- [V6 Documentation md](/Docs/ExifToolGUI_V6.md)
- [Docs directory](Docs/)

Frank

0 comments on commit 3e37266

Please sign in to comment.