Universal Selection

A universal file selection getter for Raycast extensions. Automatically detects the frontmost file manager application and retrieves selected files.

Features

• Support for multiple file managers
• Easy integration with Raycast extensions
• Compatible with Raycast's getSelectedFinderItems API

Installation

npm install universal-selection

Usage

import { getSelectedItems } from "universal-selection";
import { showToast, Toast } from "@raycast/api";

export default async function Command() {
  try {
    const files = await getSelectedItems();
    
    if (files.length === 0) {
      await showToast({
        style: Toast.Style.Failure,
        title: "No files selected",
      });
      return;
    }

    // Process your files - same format as getSelectedFinderItems
    console.log("Selected files:", files);
    // [{ path: "/Users/username/Documents/file.txt" }, { path: "/Users/username/Pictures/image.png" }]
    
    files.forEach(file => {
      console.log(`Processing: ${file.path}`);
    });
    
  } catch (error) {
    await showToast({
      style: Toast.Style.Failure,
      title: "Error",
      message: error.message,
    });
  }
}

API

getSelectedItems()

Returns a promise that resolves to an array of file system items.

Returns: Promise<Array<{ path: string }>>

Throws:

• Error - If the frontmost application bundle ID cannot be determined
• Error - If the frontmost application is not supported

Example:

const files = await getSelectedItems();
// [{ path: "/path/to/file1.txt" }, { path: "/path/to/file2.png" }]

// Access file paths
files.forEach(file => console.log(file.path));

Supported Applications

| Application | Bundle ID | Status | |------------|-----------|--------| | Finder | com.apple.finder | ✅ Supported | | Bloom | com.asiafu.Bloom | ✅ Supported | | QSpace | com.jinghaoshe.qspace(.pro) | ✅ Supported | | Path Finder | com.cocoatech.PathFinder | ✅ Supported |

Want to add support for more file managers? Open an issue or submit a pull request!

Development

Adding Support for New File Managers

1. Create a new file in src/apps/ (e.g., my-app.js)
2. Implement the selection getter function
3. Add the bundle ID case in src/index.js
4. Update the README

Example:

// src/apps/my-app.js
import { runAppleScript } from "@raycast/utils";

export async function getMyAppSelection() {
  const script = `
    tell application "MyApp"
      -- Your AppleScript here
    end tell
  `;
  const result = await runAppleScript(script);
  return result.trim().split("\n");
}

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.