MCPcopy Index your code
hub / github.com/amarsbar/rice-cooker

github.com/amarsbar/rice-cooker @v0.1.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.1.2 ↗ · + Follow
333 symbols 757 edges 48 files 34 documented · 10%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Rice Cooker hero image

rice cooker

a visual (toy) tool for ricing hyprland.

browse rices, try them live on your desktop, and install them with a keyboard click. if you don't like what you see, revert returns you to the original rice you started with.

rice cooker only points quickshell at your selected rice. it does not overwrite your existing files or directories, and does not modify your dotfiles.

https://github.com/user-attachments/assets/e5a63109-de89-48cc-a703-f249222df6f6

notice

rice cooker currently only works on arch + hyprland and only contains quickshell rices. close any non-quickshell rice when using.

rice cooker's boot screen automatically rejects non-supported setups. forcible entry is possible but rice at your own risk.

install

yay -S rice-cooker
# or paru

user guide

rice cooker has two modes: (1) browse and (2) preview. Rice Cooker interface blueprint showing browse and preview modes

1. browse mode (expanded)

explore rices from the community.

  • 1.1 menu (ESC)
  • revert (hold ↵ to confirm)
  • submit a rice
  • credits
  • 1.2 close — exit rice cooker
  • 1.3 sound — toggle sound on and off
  • 1.4 theme — switch between 3 colour themes
  • 1.5 HUD — provides context like rice name, rice number, keyboard press indicators

2. preview mode (mini)

selecting a rice shows a live preview on your actual desktop. during this mode rice cooker collapses to give the rice room to breathe.

  • 2.1 antenna — extends when content is downloading
  • 2.2 leave — exit preview and revert to your original rice
  • 2.3 install — install the selected rice
  • 2.4 dot — opens the rice's dotfiles on github

preview and install times depend on the size of the rice. you may be prompted for a password when installing dependencies.

rice cooker is best experienced with the keyboard and sound on.

  • ↑ move selection up
  • ↓ move selection down
  • ↵ apply selection

submitting a rice

the rice cooker catalog is built from dotfiles openly shared by the community. share a rice of your own with us (and everyone) through the link below.

a good rice is organized and complete. every submission is reviewed before it lands in the catalog.

→ submit a rice

credits

made for fun by two brothers at butterfly.

website  |  x  |  instagram

Extension points exported contracts — how you extend this code

ScreenContentProps (Interface)
Picking-state card content: header on top, focused rice preview below. * Fades + translates to stay centered while the
src/pages/pick-a-rice/components/ScreenContent.tsx
Window (Interface)
(no doc)
src/global.d.ts
RiceListRow (Interface)
(no doc)
src/shared/backend.ts
ScrollState (Interface)
(no doc)
src/pages/pick-a-rice/view.tsx
BackendRunRequest (Interface)
(no doc)
src/shared/backend.ts
ThemeCtxValue (Interface)
(no doc)
src/pages/pick-a-rice/view.tsx
BackendRunResult (Interface)
(no doc)
src/shared/backend.ts
PhysicalControlsProps (Interface)
(no doc)
src/pages/pick-a-rice/components/PhysicalControls.tsx

Core symbols most depended-on inside this repo

step
called by 34
backend/src/install/pipeline.rs
cx
called by 14
src/pages/pick-a-rice/components/MenuScreen.tsx
playRiceSound
called by 13
src/pages/pick-a-rice/sounds.ts
run
called by 11
backend/src/main.rs
emit_fail
called by 10
backend/src/install/pipeline.rs
useView
called by 10
src/pages/pick-a-rice/view.tsx
emit
called by 9
backend/src/events.rs
write
called by 7
electron/main/index.ts

Shape

Function 260
Method 34
Class 16
Interface 15
Enum 8

Languages

Rust60%
TypeScript40%

Modules by API surface

backend/src/install/pipeline.rs51 symbols
backend/src/paths.rs38 symbols
electron/main/index.ts24 symbols
backend/src/process.rs22 symbols
backend/src/install/record.rs20 symbols
backend/src/deps.rs17 symbols
src/pages/pick-a-rice/components/ScrollWheel.tsx14 symbols
src/pages/pick-a-rice/components/PhysicalControls.tsx13 symbols
src/pages/pick-a-rice/components/MenuScreen.tsx13 symbols
backend/src/catalog.rs12 symbols
src/pages/pick-a-rice/view.tsx10 symbols
src/pages/pick-a-rice/components/RiceList.tsx9 symbols

For agents

$ claude mcp add rice-cooker \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page