FunPay Viper Reimagined

An Intuitive and Powerful Automation Agent for FunPay Transactions

We strongly recommend joining our official Telegram Support Hub (Click Here) for community assistance and immediate help.

:clipboard: Navigation Index

• Core Capabilities

  • FunPay Marketplace Interfacing
  • Telegram Notification & Control Layer
  • Extensible Features

• Key Benefits

  • For End-Users
  • For Software Engineers

• Module System

• Deployment Instructions
  • Windows Environment
  • Linux (Ubuntu) Environment
• Plugin Installation Guide
• Seeking Technical Support
• Show Your Appreciation

:robot: Core Capabilities

:shopping_cart: FunPay Marketplace Interfacing

• Automated fulfillment of digital goods upon purchase.
• Proactive relisting/boosting of active marketplace advertisements.
• Immediate, predefined replies to standardized buyer prompts.
• Self-restoration of inventory counts post-transaction completion.
• Automatic temporary suspension of listings when stock reaches zero.
• Perpetual 'Online' presence simulation.
• Direct transaction alerts piped to Telegram.
• Full command and control functionality via Telegram interface.

:left_speech_bubble: Telegram Notification & Control Layer

• Support for multi-channel notification configuration.
• Alerts for advertisement promotion events.
• Alerts for newly initiated purchase orders.
• Confirmation notifications upon successful delivery.
• Real-time alerts for inbound buyer messages.
• Capability to issue responses directly from the Telegram client.
• Granular configuration of auto-delivery logic, auto-responders, and all FPV operational modules.
• Ability to define specific auto-delivery rules per FunPay item ID.

:gear: Extensible Features

• Dynamic text substitution using internal system variables within automated responses/deliveries.
• Facilitation of custom functionality additions via a dedicated plugin architecture, eliminating the need to modify core source code.

:1st_place_medal: Key Benefits

:grinning: For End-Users

• Superiority in Functionality: Exceeds requirements for essential automation tools.
• Resource Efficiency: Minimal overhead required: ~20MB disk space, max 50MB RAM utilization, standard network access is sufficient for operation.
• Cross-Platform Portability: Operates seamlessly on any operating system supported by the underlying Python runtime (Windows, Linux, mobile OS variants, etc.).
• Unparalleled Flexibility: The plugin architecture grants vast latitude in tailoring the default behavior to niche operational requirements.
• Configuration Simplicity: Intuitive and straightforward configuration files utilizing the INI format.
• Active Maintenance: Frequent updates, prompt addressing of bugs, and active incorporation of new feature suggestions.
• Centralized Management: Complete operational oversight achievable solely through the Telegram application.

:computer: For Software Engineers

• Language Choice: Implemented in Python, chosen for its simplicity and robust capabilities in this application domain.
• Code Transparency: Comprehensive code documentation, featuring docstrings and type hints for all methods, classes, and functions.
• Robust Architecture: Extensive use of Object-Oriented Programming (OOP); transactional data (orders, messages) are represented as distinct class instances, not merely JSON blobs.
• Plugin Development Ease: Simplified mechanism for extending capabilities.
• Professional Logging: Utilizes a configured logger; direct print statements are eliminated.
• Independent API: Includes a standalone FunPayAPI Python package, decoupled from the Viper application itself.
• Personal Support: Direct support access from the primary contributor.

:electric_plug: Module System

• Official Plugin Repository Link

:arrow_down: Deployment Instructions

Virtual Private Servers (VPS) can be provisioned via providers like FirstByte. We recommend utilizing Ubuntu version 20.04 or newer; other VPS specifications are generally flexible.

:large_blue_diamond: Windows Environment

1. Install the required Python interpreter from this specific build.
   1. Crucially, ensure the checkbox for Add python.exe to PATH is activated during the initial setup screen.
2. Download the source archive for FunPay Viper.
3. Extract the FunPayViper-main directory to your preferred location.
4. Navigate into the newly extracted FunPayViper-main directory.
5. Execute the batch file named Setup.bat. Wait for all necessary dependencies to download and install.
6. Close the terminal window, then launch the application using Start.bat.

:hotsprings: Linux (Ubuntu) Environment

1. Execute the following combined shell command: wget https://raw.githubusercontent.com/FunPayViper/FunPayViper/main/install-fpv.sh -O install-fpv.sh && bash install-fpv.sh
2. Follow the prompts provided by the automated setup script. This script handles all prerequisite installations and initiates the bot as a persistent background service.

Troubleshooting: Resolving latin-1 Encoding Issues

If you encounter errors pertaining to locale or latin-1 encoding, execute the following sequence of commands:

1. Run:
   sudo apt-get install language-pack-ru
2. Run:
   sudo apt-get install language-pack-gnome-ru
3. Run:
   sudo apt-get install language-pack-kde-ru
4. Terminate the current shell session:
   exit
5. Re-establish your connection to the server.
6. Set the system locale:
   sudo update-locale LANG=ru_RU.utf8
7. If the previous step fails, return to step 4 and repeat the process.
8. Re-attempt the initial installation script execution: wget https://raw.githubusercontent.com/FunPayViper/FunPayViper/main/install-fpv.sh -O install-fpv.sh && bash install-fpv.sh
9. If errors persist, revert to step 4 and continue troubleshooting.

:electric_plug: Plugin Installation Guide

Security Warning: Exercise extreme caution when installing modules from unverified sources. The plugin system grants comprehensive access to your device and FunPay account credentials. Installation is designed to be straightforward.

1. Send the command /menu to the supervising Telegram bot.
2. Tap the navigation button labeled ▶️ Next.
3. Select the option 🧩 Plugins.
4. Select the action button ➕ Add Plugin.
5. Forward or directly send the plugin file to the bot interface.

:question: Technical Support

Should any operational queries remain unresolved, our team is available to assist you within our dedicated Telegram community forum.

:star: Endorsement

If FunPay Viper provides you with a significant operational advantage, kindly show your support by clicking the :star: star icon :star: located in the upper right corner of this project's GitHub page (a valid GitHub login is required for this action) :)