Merge pull request #1 from grothedev/copilot/clean-up-and-organize-repomaster

Clean up top-level repo layout and document the script inventory

7 files changed, 85 insertions, 3 deletions

diff --git a/.gitignore b/.gitignore
index a132b58..d415f8b 100755
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,12 @@
 cpfiles.sh
 filepaths.txt
 *__pycache__*
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+.DS_Store
+gemini-rs/target/
diff --git a/README.md b/README.md
index 4362560..81f344f 100755
--- a/README.md
+++ b/README.md
@@ -1,5 +1,78 @@
-this repo contains some of my scripts that i use on my laptop. some of them are used in conjunction with systemd services. most of them won't be of any use to anyone else. some of them may need to be modified to work with other systems. 
+# randomscripts
 
+This repository contains personal utilities and experiments used on a Linux laptop.
+Some scripts are system-specific, some expect local services or paths, and a few are
+small standalone projects.
 
-TODO:
-- organize into utilities and random, etc.
+## Repository layout
+
+- `fimon/` - file monitoring and SCP transfer utility
+- `gemini-rs/` - Rust Gemini CLI
+- `systemd/` - checked-in systemd unit files
+- `templates/` - starter templates for new Python scripts and REPL tools
+- `v4l-tool/` - Video4Linux helper scripts
+
+## Root-level script groups
+
+### System administration and monitoring
+- `disk_health_report.sh`
+- `procinfo.sh`
+- `procwatch.sh`
+- `sshd-secmon.sh`
+- `sensitive-data-defender.sh`
+- `log_temps`
+- `update_datasync_service`
+- `update_hosts`
+
+### Sync and file movement
+- `syncdata`
+- `syncdata.py`
+- `save.sh`
+- `watchfilemodify_dothing.sh`
+- `mostrecentrecursively.sh`
+- `recentlymodifiedfilesrec.sh`
+- `movetextfiles.sh`
+
+### Media and desktop helpers
+- `capture.sh`
+- `ffmpeg-repl.py`
+- `ffmpeg-suite.sh`
+- `imgs2vid.sh`
+- `vidconcat.sh`
+- `videdit.py`
+- `wallpaper_change`
+- `togglemic`
+
+### Network and web utilities
+- `whatip`
+- `webutils.py`
+- `initWifiHotspot.sh`
+- `extractcontentfromhtml.py`
+- `gemini.py`
+- `ws-repl.py`
+
+### Text, search, and random utilities
+- `ogrep`
+- `totxt`
+- `pass2txt.sh`
+- `randfile.sh`
+- `randomreminder.sh`
+- `wordle.py`
+- `wow.py`
+- `wow2.py`
+- `wow3.py`
+
+### Low-level and experimental tools
+- `bpftrace-checkping`
+- `bpftrace-execve`
+- `bpftrace-execve-2args`
+- `ncurses-exitmenu.cpp`
+- `mcs`
+- `sfm`
+- `wpdl`
+
+## Notes
+
+- Many scripts assume Linux tools such as `systemd`, `ffmpeg`, `scp`, `nmap`, or `bpftrace`.
+- Some scripts contain hard-coded paths or hostnames and should be reviewed before reuse.
+- Generated artifacts should stay out of the repo; see `.gitignore` for ignored build output.
diff --git a/datasync.path b/systemd/datasync.path
index 3319c1d..3319c1d 100755
--- a/datasync.path
+++ b/systemd/datasync.path
diff --git a/datasync.service b/systemd/datasync.service
index 3d7de2a..3d7de2a 100755
--- a/datasync.service
+++ b/systemd/datasync.service
diff --git a/update-hosts.service b/systemd/update-hosts.service
index 2aa6111..2aa6111 100755
--- a/update-hosts.service
+++ b/systemd/update-hosts.service
diff --git a/python-template.py b/templates/python-template.py
index fda7a42..fda7a42 100644
--- a/python-template.py
+++ b/templates/python-template.py
diff --git a/repl-template.py b/templates/repl-template.py
index 715eaf8..715eaf8 100644
--- a/repl-template.py
+++ b/templates/repl-template.py