ATOM (A Tool Of Mine)
.png){kind=icon}
What is ATOM?
ATOM is a launcher for PowerShell scripts, batch scripts, and executables. Although ATOM comes with many plugins preloaded, its modular nature invites people to create and add their own scripts. ATOM is coded in PowerShell and uses WPF for its UI.
How to Launch ATOM
Launch directly from PowerShell (requires internet)
irm http://tinyurl.com/run-atom | iexDirect download links
[!IMPORTANT] Double-click plugins to launch.
Recommended Setup
Below is the recommended way to setup ATOM for continued use:
- Download the latest ATOM build
- [Optional] Extract the latest build to the root of a flash drive
- Launch ATOM.bat from the flash drive
- Double-click the "ATOM Store" plugin
- Within ATOM Store, select PowerShell Core and any other plugins you may regularly use, click the "Run" button and exit when completed
PE Functionality
If ATOM is on the root of a flash drive that has Windows PE installed on it, you can click the "PE" button in the titlebar. Clicking this button will reboot the computer to Windows PE.
If you are booted to Windows PE or RE, you can launch ATOM by performing the following:
- Launch Command Prompt
- Navigate to the directory where ATOM is located. This is typically done with the following command:
cd D: - Launch ATOM.bat. This can be done with the following command (press 'Enter' twice):
ATOM.bat
When ATOM is launched in Windows PE or Windows RE, you will have a "MountOS" button in the titlebar. Clicking this button will launch MountOS which allows you to mount the registry hives from a selected drive. Performing this allows some plugins to work in PE/RE.
Customizing ATOM
Adding Plugins Categories
- Navigate to ATOM directory.
- Create a new folder named "Plugins - CategoryName" where CategoryName is your desired Category name.
- If ATOM has already been launched, you can reload plugins and plugin categories by clicking the Refresh ↻ icon.
Adding Plugins
- Navigate to ATOM directory.
- Open the plugin folder you would like to add your plugin to. (EX: "Plugins - Data Services")
- Place your PowerShell script, batch script, or executable in the folder.
- If ATOM has already been launched, you can reload plugins and plugin categories by clicking the Refresh ↻ icon.
Adding Plugin Icons
- Navigate to "ATOM\Dependencies\Icons\Plugins"
- Place plugin's PNG file in directory (PNG file must have same name as the plugin, EX: if plugin is "Plugin.ps1", PNG icon must be "Plugin.png")
Configure Plugin Parameters
You can customize parameters for each plugin such as adding tooltips, hiding the plugin by default, and silently launching the plugin.
- Navigate to "ATOM\Dependencies", open "Plugins-Hashtable (Custom).ps1" and open with a text editor.
- Add entries to the "customPluginInfo" hashtable for any plugin you would like to set parameters for. Documentation and an example are provided in the file.