Support

Product: USB Drive Eject for Windows & Mac (Stream Deck plugin for Windows and Mac) · Provider: GRAMSHIFT (Tokyo, Japan)

Product page: USB Drive Eject for Windows · Get it on the Elgato Marketplace

Contact

Email contact@gramshift.com in English or Japanese. We reply within 7 business days, usually sooner. Please include your Windows or macOS version, your Stream Deck app version, what the key shows, the text under Status in the key's settings, and the kind of drive (for example "USB stick", "USB hard disk in an enclosure", "card reader").

Eject Drive

  1. Install the plugin from the Elgato Marketplace. In the Stream Deck app, find USB Drive Eject for Windows & Mac (before version 1.2: USB Drive Eject for Windows) in the action list and drag Eject Drive onto a key.
  2. Select the key and choose the Drive (only USB drives that can be ejected are listed):
  3. Press the key. It turns amber and shows PRESS AGAIN with a 3 second countdown. Press it again within 3 seconds to eject. A second press within 0.3 seconds of the first counts as the same press, so a bump never ejects anything. If you prefer, set Confirm to Hold for 1 second: then hold the key until the bar is full; letting go earlier cancels.
  4. When the drive was ejected, the key shows a green frame and EJECTED — safe to remove. You can unplug the drive.
  5. Right before ejecting, the plugin reads the drive list again. If another device now has the drive letter, or the drive was unplugged, nothing is ejected and the key shows CHANGED.

If a program is using the drive

Eject All and Drive Count

What the key shows

KeyMeaning
Eject symbol, size, press twice / hold 1 sReady. The top line shows the drive letter and its name.
Amber, PRESS AGAINWaiting for the confirming press (countdown).
Blue frame, EJECTINGThe system is ejecting the device (a few seconds at most).
Blue frame, WAITING, a program and secondsIf in use is set to wait: the program is still using the drive, and the key tries again until it is free. Press the key to stop.
WAITING or BUSY, for E: or ejecting E:, (another key)You pressed this key while another key is ejecting or waiting for a drive. Only one eject runs at a time; this key works again when that one is done.
--, choose againEject Drive chosen by name: the saved drive is not found and two or more connected drives look the same. Choose the drive again under Drive.
Green frame, EJECTEDDone; safe to remove. Other drive letters on the same device (partitions) are removed too.
Red, IN USE and a program nameThe system refused because a program has files open on the drive. When the system reports which program, its name is shown. Close the files or the program and press twice again. files open: the system did not say which program.
Red, IN USE, needs admin (Windows) / not allowed (Mac)A policy on this computer only lets administrators eject drives (set by your organization). The plugin never asks for administrator rights.
Red, CHANGEDThe drive changed between the two presses. Nothing was ejected.
Red, ERRORThe plugin could not ask the system (see "The key shows ERROR" below).
Gray, SYSTEM, INTERNAL, FIXED, PAGE FILE, PLUGIN, SPANNED, SHARED, NOT A DISK, UNKNOWN, and on a Mac IMAGE, TIME MACHINEThis drive is never ejected (see below). Pressing only shows the warning triangle.
Gray, --, no USB drive / E: not hereNo USB drive, or the chosen letter is not connected.
Gray, the drive's name, --, not connectedThe drive chosen by name is not connected. Plug it in and the key shows its current letter.
Gray, Eject all, --, all skippedEvery connected USB drive is checked under Leave connected.

Drives that are never ejected

The plugin only ejects USB drives, and checks this twice: when the key reads the drives, and again right before it asks the system. It never ejects:

Common questions

The key shows ERROR.
The plugin could not start its connection to the system. The first start after you install it takes 1 to 3 seconds. On a Mac, the plugin uses diskutil, which comes with macOS. On some company PCs, application control or an antivirus blocks Windows PowerShell (part of Windows), which the plugin needs; ask your IT team to allow it. The text under Status shows the system's message. The plugin tries again every few seconds.

Can a single press eject a drive?
No. There is no one-press setting on purpose. Multi actions are not supported for the same reason.

What about data that is still being written?
The plugin makes the same request as "Safely Remove Hardware" (on a Mac, as Eject in the Finder): the system finishes writing and refuses the eject while a program has files open. Wait until copies have finished before you eject.

My drive gets a different drive letter each time. Which setting should I use?
Choose the drive by name under Drive. The key then follows the drive whatever letter Windows gives it, and the top of the key shows its current letter.

How do I eject everything except my backup disk?
Put Eject All on a key and check the backup disk under Leave connected. Eject All then ejects every other USB drive and leaves the backup disk connected.

Does it work on Mac?
Yes, from version 1.2: Windows 10 or later, and macOS 13 or later. On a Mac it works like Eject in the Finder, and the keys show the drive's name instead of a drive letter.

Bought direct from GRAMSHIFT?

Enter your license key in the settings of any key. If it fails, email contact@gramshift.com.

Privacy

The plugin runs entirely on your computer and sends no data anywhere. See the Privacy Policy.