updated ReadME + timestamp on dumped png/mp4

Author: ferzu13

README.md

@@ -1,8 +1,22 @@
+# k21
 
-k21-screen - A CLI tool to handle screen captures
-k21-processor - A CLI tool to handle processing of screen captures
+A collection of tools and libraries for screen capture and processing:
 
-## Compilation
+- `k21` - Core library that can be consumed by external applications
+- `k21-screen` - A CLI tool to handle screen captures
+- `k21-processor` - A CLI tool to handle processing of screen captures
+- `k21-server` - A server that provides HTTP endpoints for screen capture and processing
+
+## Library Usage
+
+The `k21` library can be used as a dependency in your Rust projects:
+
+```toml
+[dependencies]
+k21 = { git = "https://github.com/kontext21/k21" }
+```
+
+## CLI Tools Compilation
 
 ```bash
 cargo build
@@ -11,15 +25,22 @@ cargo build
 ## Usage
 
 ```bash
+# Screen capture
 ./k21-screen
+./k21-screen --fps 1 --output captures/
+
+# Processing
 ./k21-processor --mp4 file.mp4
 ./k21-processor --image file.png
 ./k21-screen --stdout | ./k21-processor --stdin
+
+# Server
+./k21-server
 ```
-Will run and capture until process is stopp
 
 ## Options
 
+### k21-screen
 - `--fps`: Screen refresh rate in fps (frames per second) - default: 1
 
 ## TODO k21-screen
@@ -34,7 +55,8 @@ Will run and capture until process is stopp
 - [ ] `--count`: Number of captures to take 
 - [ ] `--quality`: Output quality (0-100)
 
-## ideas
+## Ideas
 - processor could just be able to handle inputs without having to specify the input type
 - maybe processor could handle multiple images / inputs at once
-- how do we preserve the original time stamp
+- how do we preserve the original time stamp
+- add websocket support to server for real-time updates

libs/k21/src/capture/utils.rs

@@ -9,6 +9,7 @@ use crate::capture::screen_record;
 use super::screen_record::get_screenshot;
 use tokio::sync::watch;
 use super::ScreenCaptureConfig;
+use chrono::Local;
 
 pub async fn capture(config: ScreenCaptureConfig) -> Result<()> {
     capture_with_stdout(config, false).await
@@ -113,7 +114,7 @@ pub async fn handle_captured_frames(
         close_rx,
         &mut chunk_number,
     ).await;
-    
+
     // Save final video chunk if needed
     if config.get_save_video_to().is_some() && !screen_record.is_buf_empty() {
         save_video_chunk(
@@ -206,16 +207,22 @@ async fn send_frame_to_stdout(frame_number: u64, image: &DynamicImage) {
 }
 
 fn save_video_chunk(screen_record: &mut screen_record::ScreenCapturer, chunk_number: &mut u64, fps: f32, output_dir_video: &str) {
-    // save video chunk to disk with unique name using the provided output directory
-    let path = std::path::PathBuf::from(output_dir_video).join(format!("output-{}.mp4", chunk_number));
+
+    let timestamp = Local::now().format("%Y%m%d_%H%M%S");
+    let path = std::path::PathBuf::from(output_dir_video)
+            .join(format!("output-{}-{}.mp4", timestamp, chunk_number));
+    
     screen_record.save(&path, fps);
     *chunk_number += 1;
 }
 
 fn save_screenshot(frame_number: u64, image: DynamicImage, output_dir: &str) {
-    let output_dir = std::path::PathBuf::from(output_dir);
+
+    let timestamp = Local::now().format("%Y%m%d_%H%M%S");
+    let path = std::path::PathBuf::from(output_dir)
+        .join(format!("screenshot-{}-{}.png", timestamp, frame_number));
+
     tokio::task::spawn(async move {
-        let path = output_dir.join(format!("screenshot-{}.png", frame_number));
         match image.save_with_format(&path, image::ImageFormat::Png) {
             Ok(_) => log::info!("Saved screenshot to {}", path.display()),
             Err(e) => log::error!("Failed to save screenshot: {}", e),