Changes in 0.0.3

• Global Color Mapping Definition
  The color mapping (color_name_map) has been moved to a global scope, making it accessible throughout the script without needing to redefine it locally within functions.
• Enhanced Logging Configuration
  The configure_logging() function now includes an optional log_to_console parameter, allowing users to control whether log messages are shown in the console. By default, this parameter is set to True, showing only ERROR level messages in the console while logging all levels to the log file.
• Extended Timestamp Parsing
  Additional regular expression patterns have been added to the parse_timestamp() function to handle a wider range of timestamp formats, improving the robustness and versatility of timestamp parsing.
• Corrected Statistics Calculation
  The calculation of statistics has been corrected to ensure all values are counted accurately. This includes proper counting of total points, points with timestamps, and points without timestamps, enhancing the reliability of the reported data.
• New Statistic Metric
  A new metric, points_without_timestamps, has been added to the statistics. This metric tracks the number of geopoints that do not have associated timestamps, providing more detailed insights into the data.
• Spinner Animation During Processing
  A spinner animation has been introduced to provide visual feedback during the processing of KML files. The spinner shows the current file being processed and stops once processing is complete, improving user experience by indicating ongoing activity.

Full Changelog: v0.0.2...v0.0.3

Changes in 0.0.2

• Synchronous Processing
  The script has been updated from asynchronous to synchronous processing to enhance compatibility and reliability. The use of asyncio and aiofiles has been removed.
• File Selection Limitation
  A new feature limits the selection to a maximum of 10 KML files at a time. This constraint ensures that the script processes only a manageable number of files simultaneously.
• Enhanced Error Handling
  Improved error handling mechanisms have been introduced to catch and log specific exceptions such as FileNotFoundError, ValueError, and XMLSyntaxError more effectively.
• Input Validation
  Additional validation steps have been implemented to ensure that user inputs are correct, avoiding invalid characters or excessively long entries.
• Extended Timestamp Processing
  The timestamp parsing has been extended to support more formats, ensuring that various timestamp formats can be recognized and parsed correctly.
• Saving Statistics
  Separate Excel and CSV files (KML_Statistic.xlsx and KML_Statistic.csv) have been introduced to store detailed statistics about the processed KML files. This adds an extra layer of control and documentation, complementing the existing Merged_Colored files.
• Logging Configuration
  Logging settings have been optimized to provide a logical separation between console and file logging. Console logging now only displays messages at the WARNING level and above, while detailed debug information is still recorded in the log file.

These changes improve the script's usability, robustness, and traceability, providing more comprehensive tools for the forensic analysis of geospatial data.

Full Changelog: v0.0.1...v0.0.2

Initial release

UFEDKMLstacker is a Python script designed to merge and visualize KML files exported from Cellebrite UFED using Plotly. This tool allows the stacking of multiple KML files to demonstrate overlapping locations of different data sources, each represented by a distinct color. By integrating this functionality, UFEDKMLstacker aids in forensic analysis and visualization, offering valuable insights into spatial relationships between different entities. Inspired by UFEDMapper and UFEDKMLmerge, this script has been customized to meet specific forensic needs, enabling professionals to streamline their workflow. Sharing this tool aims to benefit others in the forensic community.