How mystiafin/amane works
Amane is a Rust library and CLI for building Wayland desktop shells. The main workflow is to create or select a Rust shell project, build and launch it (or rebuild it during development), then have the shell construct windows and widgets that the Wayland backend displays and routes input for. The library also exposes graphics, animation, IPC, and built-in desktop services. Some runtime modules are represented at their known source paths, but their internal call relationships are omitted where excerpts do not establish them.
Main entry points: services.rs Service framework · main.rs CLI commands · app.rs App entry · src Build and run
Components 23
CLI and projects
- CLI commands
cli/src/main.rs - Project creation
cli/src/new.rs - Project target
cli/src/target.rs - Build and run
cli/src - Shell source
cli/template/main.rs
Shell runtime
- App entry
src/app.rs - Wayland backend
src/wayland.rs - Display scaling
src/scale.rs - Shell IPC
src/ipc.rs
Windows and rendering
- Window management
src/window.rs - Layer windows
src/layer_window.rs - Rectangle drawing
src/widgets/rectangle/draw.rs - Text layout
src/widgets/text/lines.rs - Input routing
src/input.rs - Graphics renderer
src/graphics/renderer.rs - GPU rendering
src/graphics/gpu.rs - Animation
src/animation.rs
Shell capabilities
- Service framework
src/services.rs - App discovery
src/services/apps.rs - Notifications
src/services/notifications.rs - Network service
src/services/network.rs - Audio service
src/services/audio.rs
Other components
- Shell developer
Connections 23
- Shell developer → CLI commands: invokes
README.md - CLI commands → Project creation: dispatches
cli/src/main.rs - CLI commands → Project target: dispatches
cli/src/main.rs - CLI commands → Build and run: dispatches
cli/src/main.rs - Project creation → Shell source: creates starter
README.md - Project target → Build and run: selects project
README.md - Build and run → Shell source: builds shell
README.md - Build and run → App entry: launches shell
README.md - App entry → Wayland backend: starts backend
src/app.rs - App entry → Display scaling: configures
src/app.rs - App entry → Shell IPC: configures handlers
src/app.rs - Wayland backend → Display scaling: uses scaling
src/wayland.rs - Wayland backend → Window management: uses window state
src/wayland.rs - Layer windows → Window management: supports window API
- Rectangle drawing → Graphics renderer: draws through
src/widgets/rectangle/draw.rs - Rectangle drawing → Input routing: collects targets
src/widgets/rectangle/draw.rs - Text layout → Graphics renderer: uses font rendering
src/widgets/text/lines.rs - Graphics renderer → GPU rendering: uses GPU
- Rectangle drawing → Animation: requests frames
src/widgets/rectangle/draw.rs - Service framework → App discovery: exports service
src/services.rs - Service framework → Notifications: exports service
src/services.rs - Service framework → Network service: exports service
src/services.rs - Service framework → Audio service: exports service
src/services.rs