Release v0.1.0: merge dev into main

This reverts commit 42e48d8930.

Cargo.toml

@@ -4,3 +4,9 @@ version = "0.1.0"
 edition = "2024"
 
 [dependencies]
+chrono = "0.4.44"
+notify = "8.2.0"
+serde = { version = "1.0.228", features = ["derive"] }
+thiserror = "2.0.18"
+toml = "1.0.6"
+zip = "8.2.0"

README.md

@@ -1,3 +1,42 @@
 # UniLoader
 
-A universal library loader for KiCad
+A simple daemon that automatically imports any libraries into KiCad. It currently supports symbols and footprints from [SamacSys](https://componentsearchengine.com/), [UltraLibrarian](https://app.ultralibrarian.com/search), [SnapMagic](https://www.snapeda.com/home/)
+
+## Installation
+
+An automated install script is planned but currently the repo needs to be cloned, built and installed manually
+```
+
+git clone https://git.h3cx.dev/h3cx/UniLoader.git
+
+cd UniLoader
+
+cargo build -r
+
+```
+You will then find the binary under `target/release` you can run it manually or create a systemd service to automatically run it at boot
+
+## Usage
+
+To get started you will need to set up your config, to do so create a config file
+```
+
+mkdir ~/.config/uniloader
+
+touch ~/.config/uniloader/config.toml
+
+```
+Then use your favorite text editor to open this config and paste in the minimal config
+```
+
+[libraries]
+path = "~/KiCad/libraries/"
+
+```
+Now that you have set this up, the application should be ready to go, just head over to your favorite library website and download any component.
+
+Upon downloading the first component from a given online library you will be required to add the library to KiCad. In KiCad open your symbol editor and head to `File->Add Library` then naviagate to the path you set in your config and add the library. Repeat this from the footprint editor for the footprints libraries.
+
+## Warranty
+
+Use this program at your own risk, no warranty is provided for anything that it could do to your libraries, KiCad or operating system. If you encounter any issues feel free to open an issue.

src/main.rs

@@ -1,3 +1,458 @@
-fn main() {
-    println!("Hello, world!");
+// Copyright (C) 2026 Hector van der Aa <hector@h3cx.dev>
+// SPDX-License-Identifier: GPL-3.0-or-later
+use std::{
+    env,
+    fs::{self, File},
+    io::Read,
+    path::{Path, PathBuf},
+    sync::mpsc,
+};
+
+use notify::{Event, EventKind, RecursiveMode, Watcher, event::CreateKind};
+use serde::{Deserialize, Serialize};
+use thiserror::Error;
+use zip::ZipArchive;
+
+#[derive(Debug, Deserialize, Serialize)]
+struct Config {
+    libraries: LibConfig,
+}
+
+impl Config {
+    fn load_or_create() -> Result<Self, ConfigError> {
+        let config_path =
+            PathBuf::from(env::var("HOME").unwrap()).join(".config/uniloader/config.toml");
+
+        if config_path.exists() {
+            let contents = fs::read_to_string(&config_path).map_err(|_| ConfigError::ConfigErr)?;
+            let config: Config = toml::from_str(&contents).map_err(|_| ConfigError::ConfigErr)?;
+            Ok(config)
+        } else {
+            fs::create_dir_all(config_path.parent().unwrap())
+                .map_err(|_| ConfigError::ConfigErr)?;
+            let config = Config {
+                libraries: LibConfig {
+                    path: PathBuf::from("~/KiCad/libraries/"),
+                },
+            };
+            let contents = toml::to_string_pretty(&config).map_err(|_| ConfigError::ConfigErr)?;
+            fs::write(&config_path, contents).map_err(|_| ConfigError::ConfigErr)?;
+            Ok(config)
+        }
+    }
+}
+
+#[derive(Debug, Deserialize, Serialize, Clone)]
+struct LibConfig {
+    path: PathBuf,
+}
+
+enum SourceType {
+    SymacSys,
+    UltraLibrarian,
+    SnapMagic,
+}
+
+#[derive(Error, Debug)]
+enum ConfigError {
+    #[error("Config error")]
+    ConfigErr,
+}
+
+#[derive(Error, Debug)]
+enum SourceError {
+    #[error("Unknown Source")]
+    SourceUnknown,
+    #[error("Filename Error")]
+    FilenameError,
+}
+
+#[derive(Error, Debug)]
+enum ImportError {
+    #[error("Unknown Path")]
+    InvalidPath,
+    #[error("Corrputed Zip")]
+    InvalidZip,
+}
+
+struct SymbolLibrary {
+    version: String,
+    symbols: Vec<Symbol>,
+}
+
+struct Symbol {
+    name: String,
+    raw: String,
+}
+
+impl SymbolLibrary {
+    fn new() -> Self {
+        SymbolLibrary {
+            version: "20211014".to_string(),
+            symbols: Vec::new(),
+        }
+    }
+    fn write(&self) -> String {
+        let mut out = format!(
+            "(kicad_symbol_lib\n\t(version {})\n\t(generator \"uniloader\")\n",
+            self.version,
+        );
+
+        for sym in &self.symbols {
+            out.push_str(&sym.raw);
+            out.push('\n');
+        }
+
+        out.push(')');
+        out
+    }
+
+    fn from_str(input: &str) -> Self {
+        let input = input.replace("\r\n", "\n");
+        let mut version = String::new();
+        let mut symbols = Vec::new();
+
+        if let Some(v_start) = input.find("(version ") {
+            let rest = &input[v_start + 9..];
+            if let Some(v_end) = rest.find(')') {
+                version = rest[..v_end].trim().to_string();
+            }
+        }
+
+        let mut i = 0;
+        let chars: Vec<char> = input.chars().collect();
+
+        while i < chars.len() {
+            if input[i..].starts_with("(symbol ") {
+                let start = i;
+                let mut depth = 0;
+
+                while i < chars.len() {
+                    if chars[i] == '(' {
+                        depth += 1;
+                    } else if chars[i] == ')' {
+                        depth -= 1;
+
+                        if depth == 0 {
+                            let end = i + 1;
+                            let raw = input[start..end].to_string();
+
+                            let name = raw.split('"').nth(1).unwrap_or("unknown").to_string();
+
+                            symbols.push(Symbol { name, raw });
+
+                            break;
+                        }
+                    }
+                    i += 1;
+                }
+            }
+            i += 1;
+        }
+
+        Self { version, symbols }
+    }
+}
+
+fn main() -> notify::Result<()> {
+    let config = Config::load_or_create().unwrap();
+    println!("{:?}", config.libraries.path);
+    let (tx, rx) = mpsc::channel::<notify::Result<Event>>();
+    let mut watcher = notify::recommended_watcher(tx)?;
+    let downloads = PathBuf::from(env::var("HOME").unwrap()).join("Downloads");
+    watcher.watch(&downloads, RecursiveMode::NonRecursive)?;
+
+    for res in rx {
+        match res {
+            Ok(event) => {
+                if event.kind != EventKind::Create(CreateKind::File) {
+                    continue;
+                }
+                if !validate_zip(&event.paths[0]) {
+                    continue;
+                }
+
+                let Ok(source_type) = find_source_type(&event.paths[0]) else {
+                    continue;
+                };
+
+                match source_type {
+                    SourceType::SymacSys => {
+                        println!("SymacSys detected, Installing...");
+                        let Ok(_) = import_symacsys(&event.paths[0], &config) else {
+                            continue;
+                        };
+                    }
+                    SourceType::UltraLibrarian => {
+                        println!("UltraLibrarian detected, Installing...");
+                        let Ok(_) = import_ultralibrarian(&event.paths[0], &config) else {
+                            continue;
+                        };
+                    }
+                    SourceType::SnapMagic => {
+                        println!("SnapMagic detected, Installing...");
+                        let Ok(_) = import_snapmagic(&event.paths[0], &config) else {
+                            continue;
+                        };
+                    }
+                }
+            }
+            Err(e) => println!("watch error: {:?}", e),
+        }
+    }
+
+    Ok(())
+}
+
+fn validate_zip(path: &Path) -> bool {
+    path.is_file()
+        && path
+            .extension()
+            .and_then(|e| e.to_str())
+            .map(|e| e.eq_ignore_ascii_case("zip"))
+            .unwrap_or(false)
+}
+
+fn find_source_type(path: &Path) -> Result<SourceType, SourceError> {
+    let name = path
+        .file_name()
+        .ok_or(SourceError::FilenameError)?
+        .to_str()
+        .ok_or(SourceError::FilenameError)?;
+
+    if name.starts_with("LIB_") {
+        return Ok(SourceType::SymacSys);
+    } else if name.starts_with("ul_") {
+        return Ok(SourceType::UltraLibrarian);
+    }
+
+    let file = File::open(path).map_err(|_| SourceError::SourceUnknown)?;
+    let mut archive = ZipArchive::new(file).map_err(|_| SourceError::SourceUnknown)?;
+    for i in 0..archive.len() {
+        let Ok(mut file) = archive.by_index(i) else {
+            continue;
+        };
+        let name = file.name();
+
+        if name.to_lowercase().contains("how-to-import") {
+            let mut contents = String::new();
+            file.read_to_string(&mut contents)
+                .map_err(|_| SourceError::SourceUnknown)?;
+
+            if contents.to_lowercase().contains("snapeda") {
+                return Ok(SourceType::SnapMagic);
+            }
+        }
+    }
+    Err(SourceError::SourceUnknown)
+}
+
+fn extract_zip(path: &Path, config: &Config) -> Result<PathBuf, ImportError> {
+    let file = File::open(path).map_err(|_| ImportError::InvalidPath)?;
+    let mut archive = ZipArchive::new(file).map_err(|_| ImportError::InvalidZip)?;
+
+    let Some(file_name) = path.file_stem() else {
+        return Err(ImportError::InvalidPath);
+    };
+
+    let tmp_path = config.libraries.path.join("tmp").join(file_name);
+
+    fs::create_dir_all(&tmp_path).map_err(|_| ImportError::InvalidPath)?;
+
+    archive
+        .extract(&tmp_path)
+        .map_err(|_| ImportError::InvalidPath)?;
+
+    fs::remove_file(path).map_err(|_| ImportError::InvalidPath)?;
+    Ok(tmp_path)
+}
+
+fn import_symacsys(path: &Path, config: &Config) -> Result<(), ImportError> {
+    let tmp_path = extract_zip(path, config)?;
+
+    let data_dir = fs::read_dir(&tmp_path)
+        .map_err(|_| ImportError::InvalidPath)?
+        .filter_map(|e| e.ok())
+        .find(|entry| entry.file_type().map(|t| t.is_dir()).unwrap_or(false))
+        .map(|entry| entry.path())
+        .ok_or(ImportError::InvalidPath)?;
+
+    let kicad_dir = data_dir.join("KiCad");
+
+    let entries = fs::read_dir(&kicad_dir)
+        .map(|rd| rd.filter_map(|e| e.ok()).collect::<Vec<_>>())
+        .unwrap_or_default();
+
+    let sym_files: Vec<PathBuf> = entries
+        .iter()
+        .filter(|entry| {
+            entry
+                .path()
+                .extension()
+                .map(|e| e == "kicad_sym")
+                .unwrap_or(false)
+        })
+        .map(|entry| entry.path())
+        .collect();
+
+    let mod_files: Vec<PathBuf> = entries
+        .iter()
+        .filter(|entry| {
+            entry
+                .path()
+                .extension()
+                .map(|e| e == "kicad_mod")
+                .unwrap_or(false)
+        })
+        .map(|entry| entry.path())
+        .collect();
+
+    let root = config.libraries.path.join("SymacSys");
+    let sym = root.join("SymacSys_Components.kicad_sym");
+    let pretty = root.join("SymacSys_Footprints.pretty");
+
+    install_library(sym_files, mod_files, &root, &sym, &pretty)?;
+
+    fs::remove_dir_all(tmp_path).map_err(|_| ImportError::InvalidPath)?;
+    Ok(())
+}
+
+fn import_ultralibrarian(path: &Path, config: &Config) -> Result<(), ImportError> {
+    let tmp_path = extract_zip(path, config)?;
+
+    let data_dir = fs::read_dir(&tmp_path)
+        .map_err(|_| ImportError::InvalidPath)?
+        .filter_map(|e| e.ok())
+        .find(|entry| entry.file_type().map(|t| t.is_dir()).unwrap_or(false))
+        .map(|entry| entry.path())
+        .ok_or(ImportError::InvalidPath)?;
+
+    let pretty_dir = data_dir.join("footprints.pretty");
+
+    let root_entries = fs::read_dir(&data_dir)
+        .map(|rd| rd.filter_map(|e| e.ok()).collect::<Vec<_>>())
+        .unwrap_or_default();
+
+    let pretty_entries = fs::read_dir(&pretty_dir)
+        .map(|rd| rd.filter_map(|e| e.ok()).collect::<Vec<_>>())
+        .unwrap_or_default();
+
+    let sym_files: Vec<PathBuf> = root_entries
+        .iter()
+        .filter(|entry| {
+            entry
+                .path()
+                .extension()
+                .map(|e| e == "kicad_sym")
+                .unwrap_or(false)
+        })
+        .map(|entry| entry.path())
+        .collect();
+
+    let mod_files: Vec<PathBuf> = pretty_entries
+        .iter()
+        .filter(|entry| {
+            entry
+                .path()
+                .extension()
+                .map(|e| e == "kicad_mod")
+                .unwrap_or(false)
+        })
+        .map(|entry| entry.path())
+        .collect();
+
+    let root = config.libraries.path.join("UltraLibrarian");
+    let sym = root.join("UltraLibrarian_Components.kicad_sym");
+    let pretty = root.join("UltraLibrarian_Footprints.pretty");
+
+    install_library(sym_files, mod_files, &root, &sym, &pretty)?;
+
+    fs::remove_dir_all(tmp_path).map_err(|_| ImportError::InvalidPath)?;
+    Ok(())
+}
+
+fn import_snapmagic(path: &Path, config: &Config) -> Result<(), ImportError> {
+    let data_dir = extract_zip(path, config)?;
+
+    let entries = fs::read_dir(&data_dir)
+        .map(|rd| rd.filter_map(|e| e.ok()).collect::<Vec<_>>())
+        .unwrap_or_default();
+
+    let sym_files: Vec<PathBuf> = entries
+        .iter()
+        .filter(|entry| {
+            entry
+                .path()
+                .extension()
+                .map(|e| e == "kicad_sym")
+                .unwrap_or(false)
+        })
+        .map(|entry| entry.path())
+        .collect();
+
+    let mod_files: Vec<PathBuf> = entries
+        .iter()
+        .filter(|entry| {
+            entry
+                .path()
+                .extension()
+                .map(|e| e == "kicad_mod")
+                .unwrap_or(false)
+        })
+        .map(|entry| entry.path())
+        .collect();
+
+    let root = config.libraries.path.join("SnapMagic");
+    let sym = root.join("SnapMagic_components.kicad_sym");
+    let pretty = root.join("SnapMagic_Footprints.pretty");
+
+    install_library(sym_files, mod_files, &root, &sym, &pretty)?;
+
+    fs::remove_dir_all(data_dir).map_err(|_| ImportError::InvalidPath)?;
+    Ok(())
+}
+
+fn install_library(
+    sym_files: Vec<PathBuf>,
+    mod_files: Vec<PathBuf>,
+    lib_root: &Path,
+    sym_file: &Path,
+    pretty_dir: &Path,
+) -> Result<(), ImportError> {
+    fs::create_dir_all(lib_root).map_err(|_| ImportError::InvalidPath)?;
+    fs::create_dir_all(pretty_dir).map_err(|_| ImportError::InvalidPath)?;
+
+    // Load or create symbol library
+    let mut current_lib = if sym_file.exists() {
+        let contents = fs::read_to_string(sym_file).map_err(|_| ImportError::InvalidPath)?;
+        SymbolLibrary::from_str(&contents)
+    } else {
+        SymbolLibrary::new()
+    };
+
+    // Install symbols
+    for sym_path in sym_files {
+        let sym_str = fs::read_to_string(&sym_path).map_err(|_| ImportError::InvalidPath)?;
+        let new_lib = SymbolLibrary::from_str(&sym_str);
+
+        for symbol in new_lib.symbols {
+            if !current_lib.symbols.iter().any(|s| s.name == symbol.name) {
+                current_lib.symbols.push(symbol);
+            }
+        }
+    }
+
+    if !current_lib.symbols.is_empty() {
+        let output = current_lib.write();
+        fs::write(sym_file, output).map_err(|_| ImportError::InvalidPath)?;
+    }
+
+    // Install footprints
+    for mod_path in mod_files {
+        let filename = mod_path.file_name().ok_or(ImportError::InvalidPath)?;
+        let target = pretty_dir.join(filename);
+        fs::copy(mod_path, target).map_err(|_| ImportError::InvalidPath)?;
+    }
+
+    Ok(())
 }