From eb607d87d7511ff531e42640829cae395d5ea298 Mon Sep 17 00:00:00 2001 From: Ray Date: Tue, 7 Jul 2026 12:31:16 +0100 Subject: [PATCH] Added readme --- README.md | 46 ++++++++++++++++++++++++++++++++++++++++++ wiki/screenshot-1.png | Bin 0 -> 10530 bytes 2 files changed, 46 insertions(+) create mode 100644 README.md create mode 100644 wiki/screenshot-1.png diff --git a/README.md b/README.md new file mode 100644 index 0000000..b344be6 --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ +# Random File Runner + +> Run a file at random from a list of discovered files. + +![Screenshot](wiki/screenshot-1.png) + +--- + +## Features + +- Search for files using a wildcard pattern +- Support patterns with multiple wilcards +- Run a random file from the list +- Support global hotkey for running next file + +--- + +## Screenshots + +| Dashboard | Settings | +|-----------|----------| +| ![](wiki/screenshot-1.png) | + +--- + +## Background + +This tool is an odd one, it might just be one of those tools that are only useful to me. +I wanted to search (a set of given) directories for files that match a wildcard pattern. +Then I wanted to run a file (from that list) at random. +For example: you wanted to watch a random episode of your favourite show. + +## Acknowledgements + +This software uses a number of dependencies and assets from third-parties. +These developers and artists deserve due credit for their work and for their commitment to sharing their work freely. +Each product is released under their own particular license, for more information please visit their websites. + +- [Feather - Simply Beautiful Open Source Icons](https://feathericons.com/) +- [Lucide](https://lucide.dev/icons/) + +--- + +## 📄 License + +This project is licensed under the least restrictive terms of its dependencies, viz. MIT License. \ No newline at end of file diff --git a/wiki/screenshot-1.png b/wiki/screenshot-1.png new file mode 100644 index 0000000000000000000000000000000000000000..f23f5c0c13729d38b477fd2bbcedd871d22db358 GIT binary patch literal 10530 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 KE<(vV>^}fM7Q(~; literal 0 HcmV?d00001