1 files changed, 76 insertions, 3 deletions
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.