Merge branch 'master' into clipboardhistory

Author: unsecretised

CONTRIBUTING.md

@@ -20,3 +20,28 @@ For bug fixes, and helping people to solve their github issues: see
 1. Code must compile...
 1. A video recording / screenshot would be an added bonus in getting your pull
    request merged faster.
+
+## Codebase:
+
+```
+.
+├── bundling # Bundling related stuff, ignore for the most bit
+│   ├── entitlements.plist
+│   ├── icon.icns
+│   └── Info.plist
+├── docs # Website and documentation related stuff. If something new is added to config, then modify this as well before PR-ing
+├── Cargo.lock 
+├── Cargo.toml
+├── CONTRIBUTING.md
+├── EXTENSIONS.md
+├── LICENSE.md
+├── README.md
+└── src
+    ├── app.rs        # Main app logic
+    ├── calculator.rs # Calculator logic 
+    ├── commands.rs   # Logic for different commands
+    ├── config.rs     # Configuration related stuff
+    ├── macos.rs      # Macos specific config
+    ├── main.rs       # Start app
+    └── utils.rs      # Common functions that are used across files
+```

EXTENSIONS.md

@@ -0,0 +1,22 @@
+# RUSTCAST EXTENSIONS
+
+## Preamble:
+
+RustCast doesn't support extensions yet.
+
+However, it is in my todo list to support them.
+
+This page is currently about methods that might be used to add extensions to
+RustCast.
+
+## Methods:
+
+1. Using an MCP server.
+   - MCP Servers are used by GenAI to call functions and retrieve data.
+   - Maybe if we stripped the AI from MCP Servers, they could be used for
+     extensions, not just in rustcast, but in all projects.
+
+1. Using WASM:
+   - The way Zed does their extension support. Maybe I could also use that?
+   - Their article can be found
+     [here](https://zed.dev/blog/zed-decoded-extensions)

README.md

@@ -4,7 +4,7 @@
 > search bar that people can use to do many things, like opening apps,
 > calculators, quick-notes, etc.
 
-![RustCast Demo PreRelease V1](docs/rustcast-demo-with-v0_1_0.png)
+![RustCast Demo PreRelease V1](./docs/rustcast-demo-v0-2-0.png)
 
 ## Installation:
 
@@ -30,7 +30,7 @@ use spotlight :) Have fun!)
 
 ### Build it youself:
 
-1. Clone the repo with `git clone https://gitub.com/unsecretised/rustcast.git`
+1. Clone the repo with `git clone https://github.com/unsecretised/rustcast.git`
 1. Install `cargo bundle` with `cargo install cargo-bundle` (Requires cargo to
    be installed)
 1. Run `cargo bundle --release` to build RustCast for your system (The App Dir
@@ -54,16 +54,15 @@ bit wonky, and will be fixed in the upcoming releases
 
 ### Planned:
 
-- [ ] Select the options using arrow keys 13/12/2025
-- [ ] Calculator 15/12/2025
-- [ ] Popup note-taking 18/12/2025
-- [ ] Clipboard History 20/12/2025
-- [ ] Plugin Support 31/12/2025 (Partially implemented on 15/12/2025)
+- [ ] Select the options using arrow keys
+- [ ] Popup note-taking
+- [ ] Clipboard History
+- [ ] Plugin Support (Partially implemented on 15/12/2025)
 - [ ] Blur / transparent background (Partially implemented on 13/12/2025)
 - [ ] Hyperkey - Map CMD + OPT + CTRL + SHIFT to a physical key
 - [ ] Ability to pick between tabs in firefox / chromium browsers - using
       [Puppeteer](https://pptr.dev/)
-- [ ] Cross platform support - (1/2/2026)
+- [ ] Cross platform support
 
 ### Finished:
 
@@ -76,14 +75,20 @@ bit wonky, and will be fixed in the upcoming releases
 - [x] Customisable themes (13/12/2025)
   - [x] Configurable colours
 - [x] Spotify control - Ability to control spotify via the app
+- [x] Allow variables to be passed into custom shell scripts.
 - [x] Google your query. Simply type your query, and then put a `?` at the end,
       and press enter
+- [x] Calculator (27/12/2025)
 
-### Not Planned:
+### Not Possible by me:
 
 - [ ] Tray Icon for quitting the app. One may ask why? Well, because I CAN'T GET
       IT TO WORK.. I've SPENT TOO LONG ON THIS
 
+## If you like rustcast, consider starring it on github :)
+
+[![Star History Chart](https://api.star-history.com/svg?repos=unsecretised/rustcast&type=date&legend=top-left)](https://www.star-history.com/#unsecretised/rustcast&type=date&legend=top-left)
+
 ## Motivations:
 
 I didn't want to pay for raycast + wanted to get better at rust. Raycast in

docs/config.toml

@@ -28,3 +28,11 @@ background_opacity = 1.0
 blur = false
 show_icons = true
 show_scroll_bar = true
+
+# searching for `echo abcd > file.txt` will run `echo abcd > file.txt` as the shell command
+[[shells]]
+command = "echo "
+# icon_path is optional
+alias = "Variables 1" # the name that will be displayed in the results
+alias_lc = "var test" # the name used to search for it
+

docs/index.html

@@ -86,7 +86,7 @@ <h1>
             <div class="preview-glow"></div>
 
             <div class="preview-inner">
-              <img src="rustcast-demo-with-v0_1_0.png" />
+              <img src="rustcast-demo-v0-2-0.png" />
             </div>
 
             <div class="ferris-tag">

docs/rustcast-demo-v0-2-0.png

@@ -1,4 +1,5 @@
 use crate::clipboard::ClipBoardContentType;
+use crate::calculator::Expression;
 use crate::commands::Function;
 use crate::config::Config;
 use crate::macos::{focus_this_app, transform_process_to_ui_element};
@@ -26,15 +27,18 @@ use rayon::iter::{IntoParallelRefIterator, ParallelIterator};
 use rayon::slice::ParallelSliceMut;
 
 use std::cmp::min;
-use std::fs;
 use std::time::Duration;
+use std::{fs, thread};
 
 pub const WINDOW_WIDTH: f32 = 500.;
 pub const DEFAULT_WINDOW_HEIGHT: f32 = 65.;
 
+pub const RUSTCAST_DESC_NAME: &str = "RustCast";
+
 #[derive(Debug, Clone)]
 pub struct App {
     pub open_command: Function,
+    pub desc: String,
     pub icons: Option<iced::widget::image::Handle>,
     pub name: String,
     pub name_lc: String,
@@ -45,23 +49,25 @@ impl App {
         vec![
             App {
                 open_command: Function::Quit,
+                desc: RUSTCAST_DESC_NAME.to_string(),
                 icons: None,
                 name: "Quit RustCast".to_string(),
                 name_lc: "quit".to_string(),
             },
             App {
                 open_command: Function::OpenPrefPane,
+                desc: RUSTCAST_DESC_NAME.to_string(),
                 icons: None,
                 name: "Open RustCast Preferences".to_string(),
                 name_lc: "settings".to_string(),
             },
         ]
     }
 
-    pub fn render(&self, show_icons: bool) -> impl Into<iced::Element<'_, Message>> {
+    pub fn render(&self, theme: &crate::config::Theme) -> impl Into<iced::Element<'_, Message>> {
         let mut tile = Row::new().width(Fill).height(55);
 
-        if show_icons {
+        if theme.show_icons {
             if let Some(icon) = &self.icons {
                 tile = tile
                     .push(Viewer::new(icon).height(35).width(35))
@@ -75,26 +81,30 @@ impl App {
             }
         }
 
-        tile = tile
-            .push(
-                Button::new(
-                    Text::new(self.name.clone())
-                        .height(Fill)
-                        .width(Fill)
-                        .align_y(Vertical::Center),
-                )
-                .on_press(Message::RunFunction(self.open_command.clone()))
-                .style(|_, _| iced::widget::button::Style {
-                    background: Some(iced::Background::Color(
-                        Theme::KanagawaDragon.palette().background,
-                    )),
-                    text_color: Theme::KanagawaDragon.palette().text,
-                    ..Default::default()
-                })
-                .width(Fill)
-                .height(55),
+        tile = tile.push(
+            Button::new(
+                Text::new(&self.name)
+                    .height(Fill)
+                    .width(Fill)
+                    .color(theme.text_color(1.))
+                    .align_y(Vertical::Center),
             )
+            .on_press(Message::RunFunction(self.open_command.clone()))
+            .style(|_, _| iced::widget::button::Style {
+                background: Some(iced::Background::Color(
+                    Theme::KanagawaDragon.palette().background,
+                )),
+                text_color: Theme::KanagawaDragon.palette().text,
+                ..Default::default()
+            })
+            .width(Fill)
+            .height(55),
+        );
+
+        tile = tile
+            .push(container(Text::new(&self.desc).color(theme.text_color(0.4))).padding(15))
             .width(Fill);
+
         container(tile)
             .style(|_| iced::widget::container::Style {
                 text_color: Some(Theme::KanagawaDragon.palette().text),
@@ -207,7 +217,7 @@ impl Tile {
                 frontmost: None,
                 focused: false,
                 config: config.clone(),
-                theme: config.theme.to_owned().to_iced_theme(),
+                theme: config.theme.to_owned().into(),
                 open_hotkey_id: keybind_id,
                 clipboard_content: vec![],
                 page: Page::Main,
@@ -242,6 +252,7 @@ impl Tile {
                     let rand_num = rand::random_range(0..100);
                     self.results = vec![App {
                         open_command: Function::RandomVar(rand_num),
+                        desc: "Easter egg".to_string(),
                         icons: None,
                         name: rand_num.to_string(),
                         name_lc: String::new(),
@@ -257,6 +268,7 @@ impl Tile {
                     self.results = vec![App {
                         open_command: Function::GoogleSearch(self.query.clone()),
                         icons: None,
+                        desc: "Search".to_string(),
                         name: format!("Search for: {}", self.query),
                         name_lc: String::new(),
                     }];
@@ -271,10 +283,25 @@ impl Tile {
                 }
 
                 self.handle_search_query_changed();
+
+                if self.results.is_empty()
+                    && let Some(res) = Expression::from_str(&self.query)
+                {
+                    self.results.push(App {
+                        open_command: Function::Calculate(res),
+                        desc: RUSTCAST_DESC_NAME.to_string(),
+                        icons: None,
+                        name: res.eval().to_string(),
+                        name_lc: "".to_string(),
+                    });
+                }
                 let new_length = self.results.len();
 
                 let max_elem = min(5, new_length);
+
                 if prev_size != new_length && self.page == Page::Main {
+                    thread::sleep(Duration::from_millis(30));
+                  
                     window::resize(
                         id,
                         iced::Size {
@@ -342,7 +369,7 @@ impl Tile {
             }
 
             Message::RunFunction(command) => {
-                command.execute(&self.config);
+                command.execute(&self.config, &self.query);
 
                 if self.config.buffer_rules.clear_on_enter {
                     window::latest()
@@ -404,9 +431,8 @@ impl Tile {
                     let mut search_results = Column::new();
                     for result in &self.results {
                         search_results =
-                            search_results.push(result.render(self.config.theme.show_icons));
+                            search_results.push(result.render(self.config.theme));
                     }
-
                     Column::new()
                         .push(title_input)
                         .push(scrollable(search_results))
@@ -476,13 +502,21 @@ impl Tile {
 
         let mut exact: Vec<App> = filter_vec
             .par_iter()
-            .filter(|x| x.name_lc == query)
+            .filter(|x| match &x.open_command {
+                Function::RunShellCommand(_, _) => x
+                    .name_lc
+                    .starts_with(query.split_once(" ").unwrap_or((&query, "")).0),
+                _ => x.name_lc == query,
+            })
             .cloned()
             .collect();
 
         let mut prefix: Vec<App> = filter_vec
             .par_iter()
-            .filter(|x| x.name_lc != query && x.name_lc.starts_with(&query))
+            .filter(|x| match x.open_command {
+                Function::RunShellCommand(_, _) => false,
+                _ => x.name_lc != query && x.name_lc.starts_with(&query),
+            })
             .cloned()
             .collect();