eBay Bid Sniper Timer

WHAT IT DOES

This script adds a real-time countdown timer and bid sniper to eBay auction pages. When you view an eBay listing, the script displays a prominent timer showing the exact time remaining in days, hours, minutes, and seconds, updating every second. The timer is color-coded—green for plenty of time, yellow for less than 10 minutes, orange for less than 5 minutes, and red for less than 1 minute. The bid sniper feature lets you set a target bid amount and a snipe time (e.g., 3 seconds before the auction ends). When the snipe time is reached, the script automatically opens the bid form, enters your target bid, and submits it—giving you a competitive edge by bidding at the last possible moment. A notification alerts you when the snipe is triggered and when the bid is placed.

WHERE IT RUNS

The script runs on eBay pages (*.ebay.com). It works on auction listing pages, bidding pages, and item detail pages. It supports both desktop and mobile views.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Enable sniper timer" toggle enables or disables the script.

- Set a "Target bid amount" to specify how much you want to bid.

- Set a "Snipe time" (seconds before the auction ends) to control when the snipe triggers.

- Click "Refresh timer" to manually restart the timer.

- Click "Reset snipe" to reset the snipe trigger so you can snipe again.

The countdown timer appears in the top-right corner of the page. The snipe feature runs automatically when you're on an auction page with the script enabled.

TECHNICAL SECTION — REAL MECHANISM

The script detects eBay auction pages by checking the URL for /itm/, /sch/, /b/, or /ulk/. It extracts the auction end time from the page by looking for elements like #vi-cdown_timeLeft, .vi-cdown_timeLeft, .countdown, .time-left, and the .eBayAuctionTime class. It also parses time strings like "2d 3h 15m" to calculate the end time. The current bid price is extracted from .vi-price, .bid-price, or .current-bid elements. The countdown timer is a fixed-position div updated every second using setInterval. The snipe function checks the remaining time every second and triggers when the remaining time is less than or equal to the configured snipe time. When triggered, it finds the bid input field (input[name="MaxBid"], input[name="Bid"]) and the bid button, enters the target bid, dispatches input and change events, and clicks the bid button. If the bid form is not visible, it attempts to click the "Place Bid" button to open the form.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. eBay frequently updates its auction page structure, which may affect the selectors used to find the end time, bid input, and bid button. If the script stops working, please check for updates. The snipe feature attempts to place a bid automatically—ensure you are logged in and have sufficient funds. The script does not guarantee that the bid will be successful, as network latency and eBay's server response time can affect the outcome. The script stores only your preferences via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.