@purpleproser/soundboard-downloader-cli 1.0.0 → 1.1.1

package/README.md

@@ -1,25 +1,24 @@
 # @purpleproser/soundboard-downloader-cli
 
-A command-line tool to download soundboard sounds from MyInstants.
+A Node.js command-line tool to download soundboard sounds from [MyInstants](https://myinstants.com).
 
-**npm Package**: `@purpleproser/soundboard-downloader-cli`
-**GitHub Repository**: [blacksagres/soundboard-downloader-cli](https://github.com/blacksagres/soundboard-downloader-cli) Built with TypeScript and Node.js.
+**📦️ npm package**: `@purpleproser/soundboard-downloader-cli`
+
+**GitHub Repository**: [blacksagres/soundboard-downloader-cli](https://github.com/blacksagres/soundboard-downloader-cli)
 
 ## Features
 
 - 🔍 Search for sounds by name using interactive prompts
 - 🎵 Preview sounds by playing them in your browser
-- ⬇️ Download individual sounds to your local machine
+- 📁 Downloads are saved directly in your current working directory
 - ✨ Simple and easy-to-use interactive interface
 
 ## Tech Stack
 
-- **TypeScript** - Type-safe development
-- **Node.js** - Runtime environment
 - **Inquirer** - Interactive CLI prompts
 - **jsdom** - HTML parsing and DOM manipulation
 - **ora** - Elegant terminal spinners
-- **open** - Opens URLs in the user's browser
+- **open** - Opens URLs in the user's browser to allow previewing the sound
 
 ## Prerequisites
 
@@ -64,6 +63,7 @@ npm link
 **Note**: This package uses the `@purpleproser` npm scope (my npm username) while the GitHub repository remains under `blacksagres`. Make sure to include the `@purpleproser/` prefix when installing!
 
 **For Developers**: If you fork this project and want to publish your own version, either:
+
 1. Use a different package name, or
 2. Create your own npm scope and update the package name, or
 3. Add `"publishConfig": { "access": "public" }` to your package.json
@@ -106,7 +106,7 @@ The CLI will guide you through an interactive process:
 
 1. **Search**: You'll be prompted to enter what sound effects you're looking for
 2. **Select**: Choose from the list of matching sounds
-3. **Action**: Decide whether to play the sound in your browser or download it to your `./temp/` directory
+3. **Action**: Decide whether to play the sound in your browser or download it to your **current working directory**
 
 ### Example Workflow
 
@@ -127,18 +127,6 @@ $ npm start
 
 ## Development
 
-### Project Structure
-
-```
-src/
-├── main.ts                          # Entry point
-├── api/
-│   └── my-instants.api.ts          # API layer for MyInstants
-├── components/                      # CLI components
-└── service/
-    └── my-instants.service.ts      # Business logic
-```
-
 ### Available Scripts
 
 - `npm start` - Run in development mode with ts-node
@@ -147,7 +135,22 @@ src/
 
 ### Download Location
 
-Downloaded sounds are saved to the `./temp/` directory in the project root.
+Downloaded sounds are saved directly in your current working directory. For example:
+
+```bash
+# If you run from /home/user/projects/
+cd /home/user/projects/
+soundboard-downloader
+# Downloads will be saved to: /home/user/projects/wilhelm-scream.mp3
+```
+
+**Tip**: Create a dedicated directory for your downloads:
+
+```bash
+mkdir my-sounds && cd my-sounds
+soundboard-downloader
+# All downloads will appear in the my-sounds directory
+```
 
 ## Contributing
 

package/dist/main.js

@@ -6,9 +6,20 @@ const ora_1 = require("ora");
 const prompts_1 = require("@inquirer/prompts");
 const open_1 = require("open");
 const file_downloader_service_1 = require("./service/file-downloader.service");
+process.on("uncaughtException", (error) => {
+    if (error instanceof Error && error.name === "ExitPromptError") {
+        console.log("👋 until next time!");
+    }
+    else {
+        // Rethrow unknown errors
+        throw error;
+    }
+});
 (async function () {
     const answer = await (0, prompts_1.input)({
         message: "What sound effects are you looking for?",
+        required: true,
+        default: "wilhelm scream",
     });
     const spinner = (0, ora_1.default)({
         text: "Loading result...",
@@ -18,7 +29,8 @@ const file_downloader_service_1 = require("./service/file-downloader.service");
     const sounds = await (0, my_instants_service_1.getSoundNodes)(answer);
     spinner.stop();
     const selection = await (0, prompts_1.select)({
-        message: "Which one to download?",
+        message: "Which one to download? (use the keyboard arrows to navigate, search for something directly)",
+        pageSize: 30,
         choices: sounds.map((sound) => ({
             name: sound.label,
             value: `${sound.label}||${sound.download_url}`,
@@ -52,8 +64,9 @@ const file_downloader_service_1 = require("./service/file-downloader.service");
             spinner: "growHorizontal",
         }).start();
         const downloadFileName = downloadUrl.split("/").pop();
+        // Download directly to current working directory
         (0, file_downloader_service_1.downloadFile)(downloadUrl, {
-            destination: `./temp/${downloadFileName}`,
+            destination: downloadFileName,
             onStart: () => downloadSpinner.start(),
             onFinish: () => downloadSpinner.stop(),
         });

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AAEA,uEAA8D;AAC9D,6BAAsB;AACtB,+CAAkD;AAClD,+BAAwB;AACxB,+EAAiE;AAEjE,CAAC,KAAK;IACJ,MAAM,MAAM,GAAG,MAAM,IAAA,eAAK,EAAC;QACzB,OAAO,EAAE,yCAAyC;KACnD,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC;QAClB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAa,EAAC,MAAM,CAAC,CAAC;IAE3C,OAAO,CAAC,IAAI,EAAE,CAAC;IAEf,MAAM,SAAS,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC7B,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,KAAK;YACjB,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,YAAY,EAAW;SACxD,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,OAAO,GAAG;QACd;YACE,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,aAAa;SACrB;KACO,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC1B,OAAO,EAAE,aAAa,KAAK,EAAE;QAC7B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAA,cAAI,EAAC,WAAW,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,IAAA,aAAG,EAAC;YAC1B,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC,KAAK,EAAE,CAAC;QAEX,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAEtD,IAAA,sCAAY,EAAC,WAAW,EAAE;YACxB,WAAW,EAAE,UAAU,gBAAgB,EAAE;YACzC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE;YACtC,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AAEA,uEAA8D;AAC9D,6BAAsB;AACtB,+CAAkD;AAClD,+BAAwB;AACxB,+EAAiE;AAEjE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,CAAC,KAAK;IACJ,MAAM,MAAM,GAAG,MAAM,IAAA,eAAK,EAAC;QACzB,OAAO,EAAE,yCAAyC;QAClD,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC;QAClB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAa,EAAC,MAAM,CAAC,CAAC;IAE3C,OAAO,CAAC,IAAI,EAAE,CAAC;IAEf,MAAM,SAAS,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC7B,OAAO,EACL,6FAA6F;QAE/F,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,KAAK;YACjB,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,YAAY,EAAW;SACxD,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,OAAO,GAAG;QACd;YACE,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,aAAa;SACrB;KACO,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC1B,OAAO,EAAE,aAAa,KAAK,EAAE;QAC7B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAA,cAAI,EAAC,WAAW,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,IAAA,aAAG,EAAC;YAC1B,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC,KAAK,EAAE,CAAC;QAEX,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAEtD,iDAAiD;QACjD,IAAA,sCAAY,EAAC,WAAW,EAAE;YACxB,WAAW,EAAE,gBAAiB;YAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE;YACtC,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purpleproser/soundboard-downloader-cli",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Easily download sounds from myinstants.com using this interactive CLI tool",
   "license": "MIT",
   "publishConfig": {
@@ -37,7 +37,6 @@
   "homepage": "https://github.com/blacksagres/soundboard-downloader-cli#readme",
   "devDependencies": {
     "@types/jsdom": "^27.0.0",
-    "@types/node": "^25.2.3",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   },