shotminer 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Naseem Ansari
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# Shotminer
+
+Shotminer is a powerful, developer-friendly **Dribbble Design Scraper CLI Tool**. It allows you to search and download high-quality UI/UX designs directly from your terminal using a highly aesthetic and modular setup built with Node.js, TypeScript, and Puppeteer.
+
+## Features
+
+- 🔍 **Automated Scraping:** Retrieve designs using just a search prompt.
+- ⏬ **Bulk Downloading:** Downloads images sequentially to a well-organized folder structure constraint to your prompt.
+- 🎨 **Beautiful CLI UX:** Utilizes interactive prompts and status spinners using Commander, Inquirer, and Ora.
+- ⚡ **Puppeteer Engine:** Efficiently fetches data bypassing general restrictions.
+- 🛠️ **Developer Friendly:** Completely typed, modular, and optimized for contribution.
+
+## Pre-requisites
+
+- Node.js (v18.x or above)
+- NPM or Yarn
+
+## Installation
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Gitnaseem745/shotminer.git
+   cd shotminer
+   ```
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+## Setup
+
+Create a `.env` file in the root of the project to configure the scraper (optional):
+```env
+# Disable or enable headless mode (default: false for true headless execution)
+HEADLESS=true
+
+# Limit how many pictures you want per command execution
+RESULTS_LIMIT=10
+
+# Destination folder name
+DESIGNS_SUBDIR=designs
+```
+
+## Usage
+
+You can use the CLI tool in varying setups. Once compiled, it acts as a standalone script.
+
+### Using Development Mode
+```bash
+npm run dev
+```
+Wait for the prompt and enter your search term (e.g., `mobile app UI design`).
+
+### Compiled Usage
+First build the TypeScript source:
+```bash
+npm run build
+```
+
+Then execute it via node:
+```bash
+npm start -- "dashboard UI" -l 5
+```
+
+Options:
+- `-l, --limit <number>` : Limit the number of designs to fetch.
+- `-h, --help` : Show help for command.
+
+## Folder Structure
+
+The application will construct a folder based on your prompt query. E.g., for `dashboard UI` it will yield the path:
+`./designs/dashboard_ui/design_1.png`

package/build/cli/index.js

@@ -0,0 +1,48 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { scrapeDesigns } from '../scraper/index.js';
+import { logger } from '../utils/logger.js';
+export async function runCLI() {
+    const program = new Command();
+    program
+        .name('shotminer')
+        .description('Dribbble Design Scraper CLI Tool')
+        .version('1.0.0')
+        .argument('[prompt]', 'Search prompt to scrape')
+        .option('-l, --limit <number>', 'Number of results to scrape', '10')
+        .parse(process.argv);
+    const options = program.opts();
+    let args = program.args;
+    let prompt = args[0];
+    if (!prompt) {
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'prompt',
+                message: 'Enter a search prompt (e.g., "mobile app UI design"):',
+                validate: (input) => input.trim() ? true : 'Prompt cannot be empty!',
+            },
+        ]);
+        prompt = answers.prompt;
+    }
+    const limit = parseInt(options.limit, 10);
+    console.log(); // Add empty line
+    const spinner = ora(`Scraping designs for "${prompt}"...`).start();
+    try {
+        const results = await scrapeDesigns({ prompt, limit });
+        spinner.succeed(`Successfully scraped ${results.length} designs!`);
+        console.log('\n--- Results ---');
+        results.forEach((res, i) => {
+            console.log(`${i + 1}. [${res.designer}] ${res.title}`);
+            console.log(`   URL: ${res.url}`);
+            console.log(`   Saved to: ${res.localPath}\n`);
+        });
+    }
+    catch (error) {
+        spinner.fail(`Scraping failed: ${error.message}`);
+        logger.error(error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;SAC/C,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,IAAI,CAAC;SACnE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAExB,IAAI,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAErB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACpC;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uDAAuD;gBAChE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB;aACrE;SACF,CAAC,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,iBAAiB;IAChC,MAAM,OAAO,GAAG,GAAG,CAAC,yBAAyB,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAEnE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,OAAO,CAAC,wBAAwB,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;QAEnE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/build/config/index.js

@@ -0,0 +1,15 @@
+import dotenv from 'dotenv';
+import path from 'path';
+import { fileURLToPath } from 'url';
+dotenv.config();
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export const config = {
+    // Application configs
+    headless: process.env.HEADLESS !== 'false', // default true
+    resultsLimit: parseInt(process.env.RESULTS_LIMIT || '10', 10),
+    designsSubdir: process.env.DESIGNS_SUBDIR || 'designs',
+    // Computed paths
+    outputDir: path.resolve(process.cwd(), process.env.DESIGNS_SUBDIR || 'designs'),
+};
+//# sourceMappingURL=index.js.map

package/build/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,sBAAsB;IACtB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,eAAe;IAC3D,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,EAAE,EAAE,CAAC;IAC7D,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS;IAEtD,iBAAiB;IACjB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS,CAAC;CAChF,CAAC"}

package/build/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runCLI } from './cli/index.js';
+process.on('unhandledRejection', (err) => {
+    console.error('Unhandled Promise Rejection:', err);
+    process.exit(1);
+});
+runCLI().catch((err) => {
+    console.error('Fatal Error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/scraper/index.js

@@ -0,0 +1,94 @@
+import puppeteer from 'puppeteer';
+import { config } from '../config/index.js';
+import { logger } from '../utils/logger.js';
+import { downloadImage } from '../utils/downloader.js';
+export async function scrapeDesigns({ prompt, limit = config.resultsLimit }) {
+    logger.info(`Starting scrape for prompt: "${prompt}" (limit: ${limit})`);
+    const browser = await puppeteer.launch({
+        headless: config.headless,
+        args: ['--no-sandbox', '--disable-setuid-sandbox', '--disable-web-security']
+    });
+    try {
+        const page = await browser.newPage();
+        // Set a realistic user agent
+        await page.setUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36');
+        await page.setViewport({ width: 1280, height: 800 });
+        const searchUrl = `https://dribbble.com/search/${encodeURIComponent(prompt)}`;
+        logger.debug(`Navigating to ${searchUrl}`);
+        await page.goto(searchUrl, { waitUntil: 'networkidle2' });
+        // Wait for the results grid to load
+        await page.waitForSelector('.shot-thumbnail', { timeout: 15000 }).catch(() => {
+            logger.warn('Could not find shots grid. Dribbble might have blocked the request or UI changed.');
+        });
+        // We will evaluate the page to extract data
+        const extractedData = await page.evaluate((maxLimit) => {
+            const shots = document.querySelectorAll('.shot-thumbnail');
+            const results = [];
+            for (let i = 0; i < shots.length; i++) {
+                if (results.length >= maxLimit)
+                    break;
+                const shot = shots[i];
+                // Find the image element inside the shot
+                const imgEl = shot.querySelector('figure img');
+                let imageUrl = imgEl?.getAttribute('data-src') || imgEl?.getAttribute('src') || '';
+                // Often Dribbble serves a low-res image. The high-res or video could be in a data-attr
+                // Look for better resolutions if available
+                const srcset = imgEl?.getAttribute('srcset') || '';
+                if (srcset) {
+                    const sources = srcset.split(',').map(s => s.trim().split(' '));
+                    // Naive approach: take the last one which is usually highest res
+                    imageUrl = sources[sources.length - 1]?.[0] || imageUrl;
+                }
+                else if (imageUrl.includes('compress')) {
+                    imageUrl = imageUrl.replace(/(compress=1&|resize=\d+x\d+)/g, ''); // Try to clean up URL
+                }
+                if (imageUrl.startsWith('data:')) {
+                    const videoEl = shot.querySelector('video source');
+                    if (videoEl) {
+                        imageUrl = videoEl.getAttribute('src') || imageUrl;
+                    }
+                }
+                const titleEl = shot.querySelector('.shot-title');
+                const title = titleEl?.textContent?.trim() || `Design ${i + 1}`;
+                const designerEl = shot.querySelector('.display-name');
+                const designer = designerEl?.textContent?.trim() || 'Unknown';
+                const linkEl = shot.querySelector('.dribbble-link');
+                const url = linkEl ? `https://dribbble.com${linkEl.getAttribute('href')}` : '';
+                if (imageUrl && !imageUrl.startsWith('data:')) {
+                    results.push({
+                        title,
+                        designer,
+                        url,
+                        imageUrl
+                    });
+                }
+            }
+            return results;
+        }, limit);
+        logger.info(`Extracted ${extractedData.length} designs. Starting downloads...`);
+        const downloadedResults = [];
+        // Download images locally
+        for (let i = 0; i < extractedData.length; i++) {
+            const item = extractedData[i];
+            try {
+                const extMatch = item.imageUrl.match(/\\.([a-zA-Z0-9]{2,5})(?:[\\?#]|$)/);
+                const ext = extMatch ? extMatch[1] : 'jpg';
+                const filename = `design_${i + 1}.${ext}`;
+                const localPath = await downloadImage(item.imageUrl, filename, prompt);
+                downloadedResults.push({
+                    ...item,
+                    localPath
+                });
+                logger.debug(`Saved ${filename}`);
+            }
+            catch (e) {
+                logger.error(`Failed to save ${item.imageUrl}: ${e.message}`);
+            }
+        }
+        return downloadedResults;
+    }
+    finally {
+        await browser.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/scraper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scraper/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAevD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,YAAY,EAAiB;IACxF,MAAM,CAAC,IAAI,CAAC,gCAAgC,MAAM,aAAa,KAAK,GAAG,CAAC,CAAC;IAEzE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,CAAC,cAAc,EAAE,0BAA0B,EAAE,wBAAwB,CAAC;KAC7E,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAErC,6BAA6B;QAC7B,MAAM,IAAI,CAAC,YAAY,CAAC,iHAAiH,CAAC,CAAC;QAC3I,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAErD,MAAM,SAAS,GAAG,+BAA+B,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;QAE3C,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QAE1D,oCAAoC;QACpC,MAAM,IAAI,CAAC,eAAe,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC3E,MAAM,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;QACnG,CAAC,CAAC,CAAC;QAEH,4CAA4C;QAC5C,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE;YACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAiB,EAAE,CAAC;YAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;oBAAE,MAAM;gBAEtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEtB,yCAAyC;gBACzC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;gBAC/C,IAAI,QAAQ,GAAG,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAEnF,uFAAuF;gBACvF,2CAA2C;gBAC3C,MAAM,MAAM,GAAG,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnD,IAAI,MAAM,EAAE,CAAC;oBACR,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;oBAChE,iEAAiE;oBACjE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;gBAC7D,CAAC;qBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBACtC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;gBAC7F,CAAC;gBAED,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;oBACnD,IAAI,OAAO,EAAE,CAAC;wBACV,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC;oBACvD,CAAC;gBACN,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,GAAC,CAAC,EAAE,CAAC;gBAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;gBACvD,MAAM,QAAQ,GAAG,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;gBAE9D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,uBAAuB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAE/E,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC9C,OAAO,CAAC,IAAI,CAAC;wBACX,KAAK;wBACL,QAAQ;wBACR,GAAG;wBACH,QAAQ;qBACT,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,MAAM,CAAC,IAAI,CAAC,aAAa,aAAa,CAAC,MAAM,iCAAiC,CAAC,CAAC;QAEhF,MAAM,iBAAiB,GAAG,EAAE,CAAC;QAE7B,0BAA0B;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC;gBACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBAC1E,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACvE,iBAAiB,CAAC,IAAI,CAAC;oBACrB,GAAG,IAAI;oBACP,SAAS;iBACV,CAAC,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/build/utils/downloader.js

@@ -0,0 +1,42 @@
+import fs from 'fs';
+import path from 'path';
+import { logger } from './logger.js';
+import { config } from '../config/index.js';
+/**
+ * Downloads an image from a URL and saves it to the output directory
+ * @param url The image URL
+ * @param filename The desired filename
+ * @param prompt Dir name derived from the prompt
+ */
+export async function downloadImage(url, filename, prompt) {
+    const dirPath = path.join(config.outputDir, prompt.replace(/[^a-z0-9]/gi, '_').toLowerCase());
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+    const filePath = path.join(dirPath, filename);
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+        }
+        if (!response.body) {
+            throw new Error('No body in response');
+        }
+        // Convert Web ReadableStream to Node.js Readable
+        const fileStream = fs.createWriteStream(filePath);
+        const reader = response.body.getReader();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            fileStream.write(value);
+        }
+        fileStream.end();
+        return filePath;
+    }
+    catch (error) {
+        logger.error(`Error downloading image ${filename}: ${error.message}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=downloader.js.map

package/build/utils/downloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.js","sourceRoot":"","sources":["../../src/utils/downloader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAc;IAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAE9F,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,iDAAiD;QACjD,MAAM,UAAU,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAEzC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,UAAU,CAAC,GAAG,EAAE,CAAC;QAEjB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,2BAA2B,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/build/utils/logger.js

@@ -0,0 +1,13 @@
+import pino from 'pino';
+export const logger = pino({
+    transport: {
+        target: 'pino-pretty',
+        options: {
+            colorize: true,
+            ignore: 'pid,hostname',
+            translateTime: 'SYS:standard',
+        },
+    },
+    level: process.env.LOG_LEVEL || 'info',
+});
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE;QACT,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,cAAc;YACtB,aAAa,EAAE,cAAc;SAC9B;KACF;IACD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;CACvC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "shotminer",
+  "author": "Naseem Ansari (GitHub: @Gitnaseem745)",
+  "version": "1.0.0",
+  "description": "A developer-friendly Dribbble Design Scraper CLI tool to search and download high-quality UI/UX designs via terminal.",
+  "main": "build/index.js",
+  "bin": {
+    "shotminer": "./build/index.js"
+  },
+  "files": [
+    "build/**/*"
+  ],
+  "scripts": {
+    "start": "node build/index.js",
+    "build": "tsc",
+    "dev": "nodemon --watch src -e ts --exec \"node --no-warnings --loader ts-node/esm\" src/index.ts",
+    "clean": "rimraf build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Gitnaseem745/shotminer.git"
+  },
+  "keywords": [
+    "scraper",
+    "cli",
+    "dribbble",
+    "ui",
+    "ux",
+    "design",
+    "puppeteer",
+    "image-downloader",
+    "web-scraping",
+    "typescript",
+    "tool"
+  ],
+  "bugs": {
+    "url": "https://github.com/Gitnaseem745/shotminer/issues"
+  },
+  "homepage": "https://github.com/Gitnaseem745/shotminer#readme",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "inquirer": "^8.2.7",
+    "ora": "^5.4.1",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "puppeteer": "^24.40.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^8.2.12",
+    "@types/node": "^25.5.0",
+    "nodemon": "^3.1.14",
+    "rimraf": "^6.1.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}