Initial commit: Eject All Disks Stream Deck Plugin

Features:
- Single button to eject all external disks on macOS
- Visual feedback with animated states (normal, ejecting, success, error)
- Customizable button title visibility
- Secure implementation using validated diskutil commands
- SVG icons with enhanced visibility
- Complete property inspector for settings

Implementation:
- TypeScript with Stream Deck SDK
- SVG-based dynamic icons
- Security-focused shell commands
- Robust error handling
- Settings persistence

Author: deverman

.editorconfig

@@ -0,0 +1,16 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = tab
+max_line_length = 120
+
+[*.{json,jsonc,md}]
+indent_size = 4
+indent_style = space
+
+[*.{yaml,yml}]
+indent_size = 2
+indent_style = space

.gitignore

@@ -0,0 +1,6 @@
+# Node.js
+node_modules/
+
+# Stream Deck files
+*.sdPlugin/bin
+*.sdPlugin/logs

.rules

@@ -0,0 +1,103 @@
+# Guidance for Building StreamDeck Plugins
+
+## Project Structure
+
+### Required Files
+- `manifest.json` - Plugin configuration, paths, and metadata
+- `*.sdPlugin` directory - Contains all plugin files
+  - `/bin` - Compiled JavaScript files
+  - `/ui` - Property Inspector HTML files
+  - `/libs` - SDK libraries and assets
+  - `/imgs` - Plugin images and icons
+
+### Property Inspector
+- Place HTML files in `/ui` directory not `/pi`
+- Always include required meta tags:
+```html
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,minimum-scale=1,user-scalable=no,minimal-ui,viewport-fit=cover">
+<meta name="apple-mobile-web-app-capable" content="yes">
+```
+- Use Stream Deck's CSS classes for consistent styling:
+  - `sdpi-wrapper` for the main container
+  - `sdpi-item` for form elements
+  - `sdpi-item-label` for labels
+  - `sdpi-item-value` for input containers
+
+## Settings Implementation
+
+### TypeScript Plugin
+- Define settings interface explicitly:
+```typescript
+type Settings = {
+  propertyName: boolean | string | number;
+};
+```
+- Use default settings object:
+```typescript
+const DEFAULT_SETTINGS: Settings = {
+  propertyName: defaultValue
+};
+```
+- Handle settings in proper lifecycle methods:
+  - `onWillAppear` - Initialize defaults
+  - `onDidReceiveSettings` - React to changes
+  - Always merge with defaults when accessing settings
+
+### Property Inspector
+- Required files:
+  - `sdpi.css` for styling
+  - `property-inspector.js` for core functionality
+- Proper WebSocket event flow:
+  1. Connect WebSocket
+  2. Register plugin
+  3. Request initial settings
+  4. Handle settings updates
+  5. Send settings changes
+
+## Button State Management
+
+### Title Options
+Only use documented properties:
+- `state`: (number) - Button state (0 or 1)
+- `target`: (Target) - Display target (Hardware, Software, both)
+✅ `setTitle("Text", { state: 0, target: Target.Hardware })`
+❌ `setTitle("Text", { color: "#FFF" })`
+
+### Image Options
+- Use SVG for dynamic icons
+- Add semi-transparent backgrounds for text contrast
+- Use stroke outlines for better visibility
+- Include error and success states
+✅ `setImage("data:image/svg+xml,${svg}", { state: 0 })`
+❌ `setImage("path.png", { tint: "blue" })`
+
+## Development Best Practices
+
+### Settings Persistence
+- Always handle undefined settings gracefully
+- Set defaults in both UI and plugin code
+- Use proper typing for type safety
+- Test settings persistence across:
+  - Stream Deck restarts
+  - Profile changes
+  - Property Inspector reopens
+
+### Error Handling
+- Log errors with streamDeck.logger
+- Show visual feedback for errors
+- Reset to normal state after errors
+- Include error recovery in state management
+
+### Testing
+- Validate plugin with `streamdeck validate`
+- Test on both hardware and software displays
+- Verify settings persistence
+- Check all state transitions
+- Test error conditions
+
+## Documentation Links
+- [Getting Started](https://docs.elgato.com/streamdeck/sdk/introduction/getting-started)
+- [Settings Guide](https://docs.elgato.com/streamdeck/sdk/guides/settings)
+- [Property Inspector](https://docs.elgato.com/streamdeck/sdk/guides/property-inspector)
+- [API Reference](https://docs.elgato.com/streamdeck/sdk/api-reference)

.vscode/launch.json

@@ -0,0 +1,16 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Attach to Plugin",
+            "type": "node",
+            "request": "attach",
+            "processId": "${command:PickProcess}",
+            "outFiles": ["${workspaceFolder}/bin/**/*.js"],
+            "resolveSourceMapLocations": ["${workspaceFolder}/**"]
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    /* JSON schemas */
+    "json.schemas": [
+        {
+            "fileMatch": ["**/manifest.json"],
+            "url": "https://schemas.elgato.com/streamdeck/plugins/manifest.json"
+        },
+        {
+            "fileMatch": ["**/layouts/*.json"],
+            "url": "https://schemas.elgato.com/streamdeck/plugins/layout.json"
+        }
+    ]
+}

README.md

@@ -0,0 +1,178 @@
+# Eject All Disks - Stream Deck Plugin
+
+A Stream Deck plugin that adds a button to safely eject all external disks on macOS with a single button press. This plugin provides visual feedback during the ejection process and allows customization of the button appearance.
+
+## Features
+
+- Single button to eject all external disks
+- Visual feedback for ejection status (normal, ejecting, success, error)
+- Customizable button title visibility
+- Safe disk ejection using macOS `diskutil`
+- Animated states during ejection
+- Comprehensive error handling with visual indicators
+
+## Requirements
+
+- macOS 12 or later
+- Stream Deck 6.4 or later
+- Stream Deck Software
+
+## Installation
+
+1. Download the latest release from the [releases page](https://github.com/brentdeverman/eject-all-disks-streamdeck/releases)
+2. Double-click the downloaded `.streamDeckPlugin` file to install it
+3. Stream Deck will prompt you to install the plugin
+
+## Usage
+
+1. Drag the "Eject All Disks" action from the "Eject All Disks" category onto your Stream Deck
+2. Press the button to eject all external disks
+3. The button will display the ejection status visually
+4. Configure the button to show or hide the title text via Settings
+
+### Button States
+
+- **Default**: Standard eject icon
+- **Ejecting**: Animated eject icon while process runs
+- **Success**: Green checkmark with eject icon
+- **Error**: Red X with eject icon
+
+### Settings
+
+In the Stream Deck button configuration:
+- **Show Title**: Toggle to show/hide the "Eject All Disks" text on the button
+
+## Security
+
+This plugin:
+- Only ejects external disks (not internal drives)
+- Uses macOS's built-in `diskutil` command with validation
+- Validates disk paths before ejection
+- Cannot access any other system resources
+
+## Development
+
+### Prerequisites
+
+- Node.js 20 or later
+- TypeScript
+- Stream Deck SDK and CLI
+
+### Project Structure
+
+```
+eject_all_disks_streamdeck/
+├── src/                    # TypeScript source files
+│   ├── actions/            # Action implementations
+│   └── plugin.ts           # Plugin entry point
+├── org.deverman.ejectalldisks.sdPlugin/  # Plugin resources
+│   ├── bin/                # Compiled JavaScript
+│   ├── ui/                 # Property Inspector HTML
+│   ├── imgs/               # Icons and images
+│   ├── libs/               # Library files
+│   └── manifest.json       # Plugin configuration
+├── dist/                   # Packaged plugin (.streamDeckPlugin)
+└── README.md               # This file
+```
+
+### Building the Plugin
+
+1. Clone the repository:
+```bash
+git clone https://github.com/brentdeverman/eject-all-disks-streamdeck.git
+cd eject-all-disks-streamdeck
+```
+
+2. Install dependencies:
+```bash
+npm install
+```
+
+3. Build the TypeScript code:
+```bash
+npm run build
+```
+
+4. Create icons and resources:
+   - SVG icons in the appropriate directories
+   - Property inspector HTML
+   - Update manifest.json
+
+5. Pack the plugin:
+```bash
+# Create dist directory if it doesn't exist
+mkdir -p dist
+
+# Pack the plugin
+streamdeck pack org.deverman.ejectalldisks.sdPlugin --output dist
+```
+
+### Implementation Details
+
+#### SVG Icons
+The plugin uses SVG icons for dynamic rendering with different states:
+- Normal state: Orange eject icon
+- Ejecting state: Animated yellow eject icon
+- Success state: Green eject icon with checkmark
+- Error state: Red eject icon with X mark
+
+Each icon includes a semi-transparent background for better text contrast.
+
+#### Settings Implementation
+Settings are implemented using:
+- TypeScript interface for type safety
+- Default values to handle initialization
+- Property Inspector for UI controls
+- WebSocket communication between UI and plugin
+
+#### Shell Command
+The plugin uses a secure shell command to safely eject disks:
+```bash
+IFS=$'\n'
+disks=$(diskutil list external | grep -o -E '/dev/disk[0-9]+')
+for disk in $disks; do
+  # Validate disk path format for security
+  if [[ "$disk" =~ ^/dev/disk[0-9]+$ ]]; then
+    diskutil unmountDisk "$disk"
+  else
+    echo "Invalid disk path: $disk" >&2
+  fi
+done
+```
+
+This implementation includes security measures like path validation and proper error handling.
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Button shows error state:**
+   - Ensure disks aren't currently in use by applications
+   - Check for file operations in progress
+   - Try ejecting through Finder first to see specific error messages
+
+2. **Settings not saving:**
+   - Restart Stream Deck software
+   - Check permissions
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+If you encounter any issues:
+1. Check the [Issues](https://github.com/brentdeverman/eject-all-disks-streamdeck/issues) page
+2. File a new issue with:
+   - macOS version
+   - Stream Deck software version
+   - Steps to reproduce
+   - Error messages if any
+
+---
+
+Made with ❤️ by Brent Deverman