This commit is contained in:
2025-11-26 09:48:14 -07:00
parent 89a7805015
commit 67867f57d4
17 changed files with 183 additions and 68 deletions

View File

@@ -1,4 +1,10 @@
Version 0.0.3 - 2025-07-029
Version 0.0.4 - 2025-11-26
* Update nuspec
* Update docs
* Minor changes
Version 0.0.3 - 2025-07-29
* Update repository info and related URLs
* Minor changes

View File

@@ -1,5 +1,3 @@
# @DatEmAll
### The Original Automated Datter
## Contributing
Let's work better together. We are looking to collaborate with like-minded people who want to contribute in any capacity. Collaboration is open to everyone and we need your help if you are a:
* Collector
@@ -22,4 +20,4 @@ Feel free to:
GitEmAll: [https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll](https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll "GitEmAll")
---
###### Copyright (c) 2016-2025 DatEmAll - All Rights Reserved v2025-07-29-00
###### Copyright (c) 2016-2025 DatEmAll - All Rights Reserved

View File

@@ -32,5 +32,5 @@ using System.Runtime.InteropServices;
// You can specify all the values or you can default the Build and Revision Numbers
// by using the '*' as shown below:
// [assembly: AssemblyVersion("1.0.*")]
[assembly: AssemblyVersion("0.0.3")]
[assembly: AssemblyFileVersion("0.0.3")]
[assembly: AssemblyVersion("0.0.4")]
[assembly: AssemblyFileVersion("0.0.4")]

View File

@@ -32,5 +32,5 @@ using System.Runtime.InteropServices;
// You can specify all the values or you can default the Build and Revision Numbers
// by using the '*' as shown below:
// [assembly: AssemblyVersion("1.0.*")]
[assembly: AssemblyVersion("0.0.3")]
[assembly: AssemblyFileVersion("0.0.3")]
[assembly: AssemblyVersion("0.0.4")]
[assembly: AssemblyFileVersion("0.0.4")]

View File

@@ -1137,15 +1137,15 @@
{
"Name" = "8:Microsoft Visual Studio"
"ProductName" = "8:DatEmAll"
"ProductCode" = "8:{8930833F-A596-47D6-9B61-8854A13E70A2}"
"PackageCode" = "8:{BD713A41-8485-4870-9334-C684D3F5C99A}"
"ProductCode" = "8:{94BBCB8D-BA38-4663-963D-8199BC3E8463}"
"PackageCode" = "8:{0D673E27-28FE-4326-845C-13F250A1B68D}"
"UpgradeCode" = "8:{D6625DD2-B677-4B12-9943-9B5CB2E2C6B8}"
"AspNetVersion" = "8:"
"RestartWWWService" = "11:FALSE"
"RemovePreviousVersions" = "11:FALSE"
"DetectNewerInstalledVersion" = "11:TRUE"
"InstallAllUsers" = "11:FALSE"
"ProductVersion" = "8:0.0.3"
"ProductVersion" = "8:0.0.4"
"Manufacturer" = "8:DatEmAll"
"ARPHELPTELEPHONE" = "8:"
"ARPHELPLINK" = "8:"

View File

@@ -25,7 +25,7 @@
<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
<PropertyGroup>
<ReleaseName>DatEmAll</ReleaseName>
<ReleaseVersion>0.0.3</ReleaseVersion>
<ReleaseVersion>0.0.4</ReleaseVersion>
<ReleasePortableName>DatEmAll-Portable</ReleasePortableName>
<ReleaseInstallerName>DatEmAll-Installer</ReleaseInstallerName>
<ReleasePackageName>DatEmAll-Package</ReleasePackageName>

View File

@@ -25,12 +25,15 @@ Project("{54435603-DBB4-11D2-8724-00A0C9A8B90C}") = "DatEmAll-Installer", "DatEm
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{FC6B1AB2-9926-43F5-965C-A7141605F636}"
ProjectSection(SolutionItems) = preProject
.gitattributes = .gitattributes
.gitignore = .gitignore
CHANGELOG.md = CHANGELOG.md
CODE_OF_CONDUCT.md = CODE_OF_CONDUCT.md
CONTRIBUTING.md = CONTRIBUTING.md
LICENSE = LICENSE
README.md = README.md
TODO.md = TODO.md
screenshot1.png = screenshot1.png
screenshot2.png = screenshot2.png
EndProjectSection
EndProject
Global

View File

@@ -107,7 +107,7 @@ namespace DatEmAll
private readonly string _libVersion = FileVersionInfo.GetVersionInfo(Assembly.GetExecutingAssembly().Location).ProductVersion;
private readonly string _libCopyright = FileVersionInfo.GetVersionInfo(Assembly.GetExecutingAssembly().Location).LegalCopyright;
private bool _appIsRegistered = false;
private string _currentAppVersion = "0.0.3";
private string _currentAppVersion = "0.0.4";
private string _commandSwitch = "-builddat";
private string _dateTimeFormatted = DateTime.Now.ToString("yyyyMMdd_HHmmss");
private ListStringLog _logLines = new ListStringLog();

View File

@@ -76,6 +76,7 @@
<None Include="DatEmAll.nuspec" />
<None Include="DatEmAll.snk" />
<None Include="packages.config" />
<None Include="Resources\Docs\DatEmAll-HELP.md" />
<None Include="Resources\Docs\DatEmAll-LICENSE.rtf" />
</ItemGroup>
<ItemGroup>

View File

@@ -6,10 +6,10 @@
<version>0.0.0</version>
<description>Use the DatEmAll Library (.dll) to build dats from anywhere in your application.
First, install or add the DatEmAll Nuget Package to your application by downloading the [nuget.nupkg](https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll/packages) to your project folder and opening a Nuget Package Manager Console in Visual Studio and type:
First, where x.x.x is the version you are installing, install or add the DatEmAll Nuget Package to your application by downloading the [datemall.x.x.x.nupkg](https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll/packages) to your project folder and opening a Nuget Package Manager Console in Visual Studio and type:
```
Install-Package nuget.nupkg
Install-Package datemall.x.x.x.nupkg
```
Then, create and use a new DatEmAll Object from anywhere in your application like the following:
@@ -28,13 +28,6 @@ DatEmAll.DatEmAll dea = new DatEmAll.DatEmAll();
<copyright>Copyright (c) 2016-2025 DatEmAll - All Rights Reserved</copyright>
<tags>DatEmAll Build Dats Automated Dat Builder Datafiles Datafile Datfiles Datfile WindowsForms WinForms Windows Forms Application Console</tags>
<repository type="git" url="https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll.git" />
<dependencies>
<group targetFramework=".NETFramework4.8">
<dependency id="Serilog" version="2.12.0" />
<dependency id="Serilog.Sinks.Console" version="4.1.0" />
<dependency id="Serilog.Sinks.LogEmAll" version="0.0.5" />
</group>
</dependencies>
</metadata>
<files>
<file src="Resources\Docs\DatEmAll-LICENSE.txt" target="LICENSE.txt" />

View File

@@ -32,5 +32,5 @@ using System.Runtime.InteropServices;
// You can specify all the values or you can default the Build and Revision Numbers
// by using the '*' as shown below:
// [assembly: AssemblyVersion("1.0.*")]
[assembly: AssemblyVersion("0.0.3")]
[assembly: AssemblyFileVersion("0.0.3")]
[assembly: AssemblyVersion("0.0.4")]
[assembly: AssemblyFileVersion("0.0.4")]

View File

@@ -0,0 +1,115 @@
# @DatEmAll
### The Original Automated Datter
## About
DatEmAll or DEA is the original app for automating the process of building datafiles. Building datafiles is vital to ROM collecting, making this software an essential app for ROM collecting.
DatEmAll comes with both a command line interface and a graphical interface. No matter which interface you choose, datting all your files is easy. Just run DatEmAll to dat all of your projects and files.
## Requirements
This software has been tested and verified working on Windows, Linux and Mac using .NET or Mono.
For Mono users, a complete installation of Mono is required. Mono does not ship with a list of Root Certificate Authorities. To install a list of Root Certificate Authorities for Mono, use the Mono "cert-sync" command as described here: https://www.mankier.com/1/cert-sync
For anyone who wants to download a list of Root Certificate Authorities to install using the "cert-sync" command, you can find regular releases here: https://curl.se/docs/caextract.html
## Installation
This software is designed to run on various operating systems, using .NET or Mono. Windows already comes with, or will automatically install .NET Framework, but you can still install and use Mono if you'd like.
First, if you are installing Mono, you should switch to the root user or System Administrator to install and use Mono and then switch to your downloademall user to install and use DatEmAll.
Next, download and unzip the program to any new location that you wish to use. However, this software should be installed as close to the drive's root directory as possible.
I like to put my installation in a directory called DEA on my Windows C:\ drive or in my Linux ~/ (home) directory. My installation layout looks like this:
C:\DEA\BASHes\
C:\DEA\Batches\
C:\DEA\Dats\
C:\DEA\ROMs\
C:\DEA\Docs\
C:\DEA\Logs\
C:\DEA\Options\
C:\DEA\DatEmAll-CLI.exe
C:\DEA\DatEmAll-GUI.exe
or
~/DEA/BASHes/
~/DEA/Batches/
~/DEA/Dats/
~/DEA/ROMs/
~/DEA/Docs/
~/DEA/Logs/
~/DEA/Options/
~/DEA/DatEmAll-CLI.exe
~/DEA/DatEmAll-GUI.exe
After this software is installed, you can create a new options file using the GUI or CLI version.
## How to Build Datafiles
If you like using a graphical interface, run the DatEmAll GUI, check the options that you want to use and click the Build Dat button to build a datafile.
If you like using a command line interface, run the DatEmAll CLI directly or use some of the provided Windows Batch files to build a datafile. Optionally, you may pass commands and options to the DatEmAll CLI. The proper syntax and help is available with -help.
Since you may set options from the command line or from an options file, an order of precedence must be established. Options from the command line will take priority over options from the options file. An options file is not mandatory, nor is passing any options from the command line. A new options file can be created using the CLI or the GUI version.
The default command used by DatEmAll builds a datafile using any default commands or commands set from the command line or options file.
## Registration
Some versions of this software require registration. It's free, easy and helps with the development of the software.
Registration is done like any other app or web site using an email/user and password created by you. Registration does not and has never asked for any personal information.
The software can be registered by using the GUI or the CLI version.
Each installation requires a separate registration. You may register as many copies of this software as you need.
## FAQ
Q1) I didn't read or follow the instructions in the help file and I can't get this software to work properly. Can you help?
A1) No.
Q2) I replaced some of the files for the newest version of this software with files from previous versions of this software, picking and choosing which files I want to replace or not replace. I can't get this software to work correctly. Can you help?
A2) Nothing in the instructions tells you to pick and choose which files to copy or replace and use from different versions of this software. This won't happen if you follow the installation instructions. Please read the Installation Section again and this time follow the instructions.
Q3) Why do I keep getting errors about path and file lengths?
A3) Obviously, you chose an installation path that is too long. This won't happen if you follow the installation instructions. Please read the Installation Section again and this time follow the instructions.
Q4) Why do I keep getting a TrustFailure error using Mono?
A4) Mono does not ship with a list of Root Certificate Authorities. To install a list of Root Certificate Authorities for Mono, use the Mono "cert-sync" command as described here: https://www.mankier.com/1/cert-sync
A4) Alternatively, you may want to disable SSL certificate verification. This will allow you to make a secure server connection, but obviously poses a security risk.
Q5) The console window stays open and pauses until I close it. I am using Linux and don't like how this works.
A5) Whether you are using Linux, Windows, Mac, or any other operating system is completely irrelevant. The BASH and Batch files are designed to be clicked and to stay open until the user closes them. If you are running commands from a Linux or Windows command line, then you should be typing the commands from the BASH or Batch file directly into the command line, not using the provided BASH or Batch files. You are always free to make your own BASH and Batch files to do anything that you want them to do.
Q6) Why doesn't my registration key work?
A6) Some registration keys may work for multiple installations on the same machine. However, installations on different machines may require a separate registration key. Make sure to use the proper registration key for each installation or the registration key may not work.
Q7) I didn't get my registration key email. Can you help?
A7) No.
## Contributing
Let's work better together. We are looking to collaborate with like-minded people who want to contribute in any capacity. Collaboration is open to everyone and we need your help if you are a:
* Collector
* Database Administrator
* Datter
* Developer
* Dumper
* Graphic Artist
* Translator
* Player
* Tester
Feel free to:
* Fork the repository
* Create an issue
* Branch your repository with the issue number and a meaningful name related to the changes you are making
* Create a pull request
## Contact
GitEmAll: [https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll](https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll "GitEmAll")
## Disclaimers
This software may only be used and/or distributed in accordance with the license with which it is distributed.
---
###### Copyright (c) 2016-2025 DatEmAll - All Rights Reserved

View File

@@ -1,18 +1,17 @@
------------------------------------------------------------------
DatEmAll - Help version 20250729
DatEmAll - Help version 20251126
Copyright (c) 2016-2025 DatEmAll - All Rights Reserved
------------------------------------------------------------------
[I] About
[II] Requirements
[III] Notes
[IV] Installation
[V] How To Build Datafiles
[VI] Registration
[VII] FAQ
[VIII] Contributing
[IX] Contact
[X] Disclaimers
[III] Installation
[IV] How To Build Datafiles
[V] Registration
[VI] FAQ
[VII] Contributing
[VIII] Contact
[IX] Disclaimers
[I] About
----------
@@ -28,13 +27,9 @@ For Mono users, a complete installation of Mono is required. Mono does not ship
For anyone who wants to download a list of Root Certificate Authorities to install using the "cert-sync" command, you can find regular releases here: https://curl.se/docs/caextract.html
[III] Notes
------------
* This software should be installed as close to the drive's root directory as possible. The nature of things dictates that there will be very long filenames. This is especially true of the TOSEC and Redump datafiles, when extracted. Keep in mind that some things may not work correctly if you choose too long of a path to put your files.
[IV] Installation
[III] Installation
-----------------
DatEmAll is designed to run on various operating systems, using .NET or Mono. Windows already comes with .NET Framework, but you can still install and use Mono if you'd like.
This software is designed to run on various operating systems, using .NET or Mono. Windows already comes with, or will automatically install .NET Framework, but you can still install and use Mono if you'd like.
First, if you are installing Mono, you should switch to the root user or System Administrator to install and use Mono and then switch to your downloademall user to install and use DatEmAll.
@@ -66,11 +61,7 @@ or
After this software is installed, you can create a new options file using the GUI or CLI version.
If you have an account at the included database, set your username and password by editing the options file directly or by editing and saving the Options file from the GUI. This will allow you upload and download any private datafiles that you have access to.
If your database username or password uses XML special characters, obviously you will need to XML encode those characters when directly editing the XML options file.
[V] How to Build Datafiles
[IV] How to Build Datafiles
--------------------------------
If you like using a graphical interface, run the DatEmAll GUI, check the options that you want to use and click the Build Dat button to build a datafile.
@@ -80,15 +71,17 @@ Since you may set options from the command line or from an options file, an orde
The default command used by DatEmAll builds a datafile using any default commands or commands set from the command line or options file.
[VI] Registration
[V] Registration
----------------
Some versions of this software require registration. It's free, easy and helps with the development of the software. Additionally, registration allows you to access any special features of this software.
Some versions of this software require registration. It's free, easy and helps with the development of the software.
Registration is done like any other app or web site using an email/user and password created by you. Registration does not and has never asked for any personal information.
The software can be registered by using the GUI or the CLI version.
Each installation requires a separate registration. You may register as many copies of this software as you need.
[VII] FAQ
[VI] FAQ
---------
Q1) I didn't read or follow the instructions in the help file and I can't get this software to work properly. Can you help?
A1) No.
@@ -110,15 +103,11 @@ Q6) Why doesn't my registration key work?
A6) Some registration keys may work for multiple installations on the same machine. However, installations on different machines may require a separate registration key. Make sure to use the proper registration key for each installation or the registration key may not work.
Q7) I didn't get my registration key email. Can you help?
A7) No. Your registration key was sent. There's no excuse for you to not know how to check and use email.
A7) No.
Q8) I appear to be blocked from some or all databases, or appear to be blocked from using this software. What gives?
A8) There are way too many reasons why this may or may not be happening. One example might be that you are using a blacklisted or abusive host, which may be blocked by some networks. In many cases, the network filtering may also be completely out of anyone's control. These problems are not caused by DatEmAll. DatEmAll goes above and beyond, giving you complete control over your network connection and providing you with the ability to use this software and upload and download dats completely anonymously.
[VIII] Contributing
[VII] Contributing
----------------
Let's work better together. We are looking to collaborate with like-minded people who want to contribute in any capacity. Our membership is open to everyone and we need your help if you are a:
Let's work better together. We are looking to collaborate with like-minded people who want to contribute in any capacity. Collaboration is open to everyone and we need your help if you are a:
* Collector
* Database Administrator
* Datter
@@ -128,11 +117,17 @@ Let's work better together. We are looking to collaborate with like-minded peopl
* Translator
* Player
* Tester
Feel free to:
* Fork the repository
* Create an issue
* Branch your repository with the issue number and a meaningful name related to the changes you are making
* Create a pull request
[IX] Contact
[VIII] Contact
----------------
GitEmAll: https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll
[X] Disclaimers
[IX] Disclaimers
----------------
This software may only be used and/or distributed in accordance with the license with which it is distributed.

View File

@@ -1,26 +1,35 @@
# @DatEmAll
### The Original Automated Datter
## About
DatEmAll or DEA is the original app for automating the process of building datafiles. Building datafiles is vital to ROM collecting, making this software an essential app for ROM collecting.
DatEmAll or DEA is the original app for automating the process of building datafiles. Building datafiles is vital to ROM collecting, making this software an essential app for ROM collecting.
DatEmAll comes with both a command line interface and a graphical interface. No matter which interface you choose, datting all your files is easy. Just run DatEmAll to dat all of your projects and files.
## Screenshots
![DownloadEmAll Screenshot 1](screenshot1.png?raw=true "DownloadEmAll Screenshot 1")
![DownloadEmAll Screenshot 2](screenshot2.png?raw=true "DownloadEmAll Screenshot 2")
## Dependencies
.NET Framework 4.8
The following frameworks and SDKs are required to develop and build this app:
* .NET Framework 4.8 or Mono compatible
The following NuGet Packages are required to build a Debug and/or Release version of this app:
The following NuGet Packages are required to develop and build this app:
* ILMerge
* Serilog
* Serilog.Sinks.Console
* Serilog.Sinks.LogEmAll
The following tools and extensions are required to be installed in your Visual Sudio IDE:
The following tools and extensions are required to develop and build this app:
* Microsoft Visual Studio Installer Projects
## Projects
* DatEmAll - Class Library
* DatEmAll-CLI - Console App
* DatEmAll-GUI - Windows Forms App
* DatEmAll-Release - Release Project
* DatEmAll-Installer - Installer Project
## Contributing
Let's work better together. We are looking to collaborate with like-minded people who want to contribute in any capacity. Collaboration is open to everyone and we need your help if you are a:
* Collector
@@ -41,6 +50,6 @@ Feel free to:
## Contact
GitEmAll: [https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll](https://gitemall.devemall.int.eu.org/TommySalami/DatEmAll "GitEmAll")
---
###### Copyright (c) 2016-2025 DatEmAll - All Rights Reserved v2025-07-29-00
###### Copyright (c) 2016-2025 DatEmAll - All Rights Reserved

View File

@@ -1,5 +0,0 @@
### To Do
* Nothing to do
### Completed Tasks
* Develop initial release

BIN
screenshot1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

BIN
screenshot2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB