🌟 Photo360 Text Effect Generator 📸

A dynamic Node.js module for generating custom text effects using ePhoto360.com. Crafted with reliability and extensibility in mind.

✨ Features

• 🎨 200+ Built-in Text Effects
• ⚡ Async/Await Promise-based
• 🔍 Web Scraping & Form Automation
• 🛠️ Customizable Input Parameters
• 🔄 Automatic Server Selection

📦 Installation

npm install abir-photo360-apis

🚀 Quick Start

const Photo360 = require('abir-photo360-apis');

async function createEffect() {
  const generator = new Photo360();
  generator.setName("Imran");
  
  try {
    const result = await generator.execute();
    console.log("Generated Image:", result.imageUrl);
  } catch (error) {
    console.error("Generation Error:", error.message);
  }
}

createEffect();

📚 API Documentation

📋 Constructor

new Photo360(url?: string)

• url: ePhoto360 effect page URL (default: Foggy Glass effect)

🔧 Methods

setName(name: string | string[])

Set text input(s) for the effect

execute(): Promise<ResultObject>

Processes the effect generation

📌 Result Object

{
  status: boolean,
  imageUrl: string,
  sessionId: string,
  author: string,
  contact: string
}

🖼️ Example Output

{
  "status": true,
  "imageUrl": "https://server12.ephoto360.com/output/123456.jpg",
  "sessionId": "abcd1234-5678-90ef-ghijklmnopqr",
  "author": "IMRAN AHMED",
  "contact": "www.facebook.com/Imran.Ahmed099"
}

🚨 Error Handling

Common Error Types:

1. Invalid URL Error - Non-ePhoto360 URLs
2. Form Parsing Error - Unexpected page structure
3. Server Connection Error - Failed API calls

try {
  // Generation code
} catch (error) {
  if (error.message.includes('Unexpected token')) {
    console.error('⚠️ Invalid effect page structure');
  }
  // Add custom error handling
}

🌐 Supported Effects

| Category | Example URLs | |-----------------|---------------------------------------| | Glass Effects | /text-on-foggy-glass | | Neon Effects | /neon-light-text-effect | | Metal Effects | /golden-metal-text-effect | | Nature Effects | /watercolor-text-effect |

📝 Notes

1. Requires Node.js 16+
2. Uses Cheerio for DOM manipulation
3. Auto-handles cookies and sessions
4. Randomizes server selection for reliability

Maintainer: Mohammad Imran
Original Author: Faris Ali
Contribution: PRs welcome!
License: MIT © 2024-2025

This design features:
1. Clear visual hierarchy with emoji markers
2. Interactive code samples
3. Responsive badges
4. Error handling guide
5. API documentation table
6. Mobile-friendly layout
7. Quick reference tables
8. Social media integration
9. Version compatibility info
10. Maintainer/contributor section

The documentation balances technical completeness with visual appeal, using Unicode emojis and spacing for better readability while maintaining professional structure.