Skip to content

giftedloser/Scriptographer

Repository files navigation

Scriptographer

Deploy PowerShell scripts to hundreds of machines. Watch them run in real time.

Latest Release    License    Built with Electron


Windows
Scriptographer

What is Scriptographer?

A deployment tool for Windows domain admins who need to push PowerShell scripts to many machines at once. Built-in Monaco editor, real-time execution logs, three execution methods, and a UI that doesn't freeze when you're hitting 200 targets.

Built with Electron + React + TypeScript. Windows only (PSRemoting, PsExec, and WinRM are Windows-native).

Features

Deployment Engine

  • Multi-target execution — deploy to hundreds of machines simultaneously
  • PSRemoting — standard WinRM-based execution (recommended)
  • Copy-First — copies scripts locally before running (restrictive environments)
  • PsExec — Sysinternals high-privilege execution (legacy)
  • Timeout & cancellation — full execution control

Script Management

  • Monaco editor — PowerShell syntax highlighting, word wrap, shortcuts
  • Categories — organize scripts into folders with drag-and-drop
  • Search & tags — find scripts instantly
  • Target groups — save and reuse lists of target computers
  • Credential support — optional auth for remote execution

Real-Time Feedback

  • Live logging — color-coded status per target (success, error, warning)
  • Execution metrics — success/failure counts per deployment
  • Full history — searchable execution history with log retention
  • Log export — export results to text files

UI & Themes

  • 4 themes — Dark, Light, Cyberpunk, Ocean
  • Responsive layout — collapsible sidebar and panels
  • Keyboard shortcutsCtrl+S save, Ctrl+D deploy, Ctrl+F search
  • Non-blocking UI — interface stays responsive during deployments

Quick Start

Grab the latest installer from Releases and run the setup.

Requirements: Windows 10/11 or Server 2016+ with PowerShell 5.1+

Development

Prerequisites: Node.js 18+

git clone https://github.com/giftedloser/Scriptographer.git
cd Scriptographer
npm install
npm run dev

Build an installer:

npm run pack
# outputs to dist/

Testing

Scriptographer includes PowerShell-based edge case and integration checks in tests/.

npm test

For the comprehensive suite:

npm run test:full

Some tests require Windows, PowerShell 5.1+, local administrator rights, WinRM, or access to test targets. See the test guide for quick runs, generated test data, and manual verification steps.

Tech Stack

Technology
Frontend React 18, TypeScript, Tailwind CSS, Radix UI, Lucide Icons
Editor Monaco Editor (PowerShell syntax)
Backend Electron 28, Node.js
Database SQLite via sql.js (in-process, no external DB)
Execution node-powershell, PSRemoting, PsExec

Project Structure

src/
  main/               Electron main process
    index.ts           App init, IPC handlers
    executor.ts        PowerShell execution engine
    database.ts        SQLite operations
  preload/             IPC bridge (context isolation)
  renderer/src/        React frontend
    components/
      ScriptLibrary    Script browser + categories
      ScriptEditor     Monaco editor panel
      ExecutionPanel   Target config + history
      OutputLog        Real-time log viewer
  shared/              Shared TypeScript interfaces

database/
  schema.sql           SQLite schema

Documentation

Detailed guides available in the docs directory:

Contributing

Contributions welcome! Open an issue or submit a PR at github.com/giftedloser/Scriptographer.

License

MIT © LoserLabs

About

Script deployment tool for domain admins. Multi-target execution, real-time logging, Monaco editor. Kills the run-and-pray workflow.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Contributors