Betfred Game filter and much more by The Devil

Betfred Game Extension

A comprehensive browser extension for managing, favoriting, and exploring Betfred games with advanced features including user statistics, win tracking, and intelligent settings memory.

Features

• Favorites: Mark/unmark games as favorites for quick access with real-time sync.
• Manual Add: Add new games manually with a clean, accessible modal and paste parsing.
• Database Import/Export: Easily export your game database and import updates.
• Bulk Remove/Re-Add: Remove or restore games by keyword with preview.
• User Statistics: Track your most played games, biggest wins, and win history.
• Win Logging: Log your wins with stake, amount, and automatic multiplier calculation.
• Settings Memory: Extension remembers your last used filters, provider, and min stake settings.
• Advanced Filtering: Filter by provider, min stake, themes (Christmas, Halloween, Easter, Sport, Big Bass, TV & Movie, Game Show).
• Random Game: Smart random game selection based on your saved preferences.
• Modern UI: Draggable modals, toast notifications, and responsive design.
• No Scan Required: Ships with a starter database—no initial scan or setup needed.

Usage

Quick Start

1. Click the extension icon to open the options panel
2. Use the provider dropdown to filter games by developer
3. Check min stake options to filter by minimum bet
4. Use theme filters (🎄 Christmas, 🎃 Halloween, etc.) for themed games
5. Click "Random Game" to play a game matching your filters

Adding Games Manually

• Open the extension panel and click the orange "+" button
• Fill in game details or paste overlay text for auto-fill
• Test both link variants to see which works
• Click Save to add the game to your database

Favoriting Games

• Click the star (☆) next to any game in the list or on the Betfred site
• Favorites sync automatically between the extension and Betfred
• Use the favorites filter to show only your favorite games

User Statistics & Win Tracking

• View Stats: See your most played game and biggest win in the Stats section
• Log Win: Click "Log Win" in Other Settings to record a win with game, stake, and amount
• My Wins: Click "My Wins" to view your complete win history with sortable columns
• Auto-tracking: Game plays are automatically tracked when you use the extension

Settings Memory

• The extension automatically remembers your last used:
• Selected provider
• Min stake checkboxes
• Active theme filter
• Settings are saved when you close the panel or use the random game button
• Your preferences are restored every time you open the panel

Importing/Exporting the Database

• Export: Click the blue "⬆️" button to download your database as JSON
• Import: Click the blue "⬇️" button to import a compatible JSON file
• Export List: Click the purple "📋" button to export a text list of games

Bulk Operations

• Bulk Remove: Remove games by keyword (Baccarat, Blackjack, Roulette, etc.)
• Bulk Re-Add: Restore previously removed games by keyword
• Access these features in the "Other Settings" section

Advanced Features

• Compact Mode: Hide headers for a more compact view
• Dark/Light Theme: Toggle between themes with the 🌙/☀️ button
• RTP Display: Show RTP percentages in the game list
• Current Tab Opening: Choose to open games in current tab or new tab

Accessibility & UI

• All modals and toasts are keyboard and screen reader accessible
• ARIA labels and roles for better accessibility
• Draggable modals for better positioning
• Responsive design that works on different screen sizes
• Cross-browser compatibility: Works in Chrome, Edge, Brave, Firefox, and other modern browsers

Editing the Database

• Export the database, edit in any text editor, and re-import
• Each game entry includes: title, provider, minStake, rtp
• The extension validates data before importing

Troubleshooting

• If you don't see changes, try reloading the extension or the Betfred page
• If you import an invalid file, a toast will notify you
• For UI issues, check for browser updates or try disabling other extensions
• Settings are automatically saved - no need to manually save preferences

Contributing

• PRs and suggestions are welcome! Please keep code clean and user-focused
• For major changes, open an issue first to discuss your idea

Contact & Support

• For help, feedback, or to report bugs, open an issue on the repository

Enjoy managing your Betfred games with advanced features and intelligent automation!



Developer Guide

Codebase Structure

project-root/
├── src/
│ ├── content.js # Content script, favorites sync, UI triggers
│ ├── ui.js # All UI logic: modals, toasts, options panel, statistics
│ ├── storage.js # Storage helpers (get/set, favorites, database, user stats)
│ ├── filters.js # Game filter functions (theme, provider, etc.)
│ ├── utils.js # Utility functions (normalization, DOM helpers)
│ └── main.js # Extension initialization and setup
├── styles.css # Main extension styles (modals, toasts, panel, themes)
├── manifest.json # Extension manifest (permissions, entry points)
├── betfred_scan_data.json # Starter game database
├── README.md # This documentation
└── ... # Assets, icons, etc.


Main Extension Flow

• main.js initializes the extension and loads storage
• content.js runs on Betfred pages, sets up favorite sync, and triggers the options panel
• ui.js handles all UI: options panel, modals, toasts, statistics, and bulk actions
• storage.js abstracts Chrome storage for games, favorites, settings, and user statistics
• filters.js provides filtering logic for game lists and themes
• utils.js contains helpers for DOM, provider normalization, etc.
• styles.css ensures a modern, accessible look for all UI components

Key Modules

• Manual Add Modal: UI and logic in ui.js (search for betfred-manual-add IDs)
• User Statistics: Win tracking and statistics in ui.js and storage.js
• Settings Memory: Automatic saving/restoring of user preferences in ui.js
• Favorites: Synced between Betfred UI and extension storage; logic in content.js and ui.js
• Database Import/Export: Handled in ui.js (look for export/import button handlers)
• Bulk Operations: UI and logic in ui.js (showBulkKeywordPopup)

Adding New Features

• UI: Add new modals or buttons in ui.js and update styles.css as needed
• Storage: Use storage.js helpers for all Chrome storage access
• New Filters: Add to filters.js and update dropdowns in ui.js
• New Actions: Add event listeners in ui.js or content.js
• Statistics: Extend the user stats system in ui.js and storage.js

Running, Testing, and Debugging

• Load the extension via chrome://extensions/ (Chrome/Edge/Brave) or about:debugging#/runtime/this-firefox (Firefox) - see Installation above
• Use the browser console for logs (lots of console.log for debugging)
• UI changes are hot-reloadable by refreshing the extension and the Betfred page
• For storage issues, use the browser's extension storage inspector
• Test settings memory by changing preferences and reopening the panel
• Cross-browser testing: Test on both Chrome and Firefox to ensure compatibility

Coding Style & Best Practices

• Use clear, descriptive variable and function names
• Keep UI logic in ui.js, storage in storage.js, and helpers in utils.js
• Use async/await for all storage and async operations
• Keep user feedback clear (toasts for all major actions/errors)
• Use ARIA roles/labels for accessibility
• Keep code DRY and modular
• Always save user settings when they interact with the panel

Submitting PRs or Issues

• Fork the repo and create a feature branch for your changes
• Write clear commit messages and document major changes in the PR
• For bugs or feature requests, open an issue with steps to reproduce or a clear description

Gotchas & Tips

• Always reload the extension after code changes
• If UI changes don't appear, try a hard refresh (Ctrl+Shift+R) on the Betfred page
• The extension expects a valid starter database (betfred_scan_data.json)
• If you add new storage keys, update storage.js accordingly
• Test in both light and dark mode for UI consistency
• Settings memory works for all user interactions - test thoroughly

API Reference

UI Functions (src/ui.js)

• showToast(msg): Show a toast notification with the given message
• createOptionsPanel(): Render the main options/settings panel
• updateGameDropdown(): Refresh the game dropdown list with current filters
• showBulkKeywordPopup(mode): Show the bulk remove/re-add modal
• makeModalDraggable(modal): Make a modal window draggable
• saveCurrentSettings(): Save current user preferences to storage
• restoreSavedSettings(): Restore saved user preferences from storage
• updateStatsArea(): Update the statistics display with current data

Storage Functions (src/storage.js)

• saveToStorage(key, value): Save a value to Chrome storage
• loadFromStorage(key, default): Load a value from Chrome storage
• getFavorites() / saveFavorites(favs): Get or set the favorites object
• getNeverShowAgain() / setNeverShowAgain(obj): Get/set "never show again" games
• incrementGamePlayCount(gamePath): Increment play count for a game

Filter Functions (src/filters.js)

• isChristmasGame(title), isHalloweenGame(title), etc.: Return true if the title matches the theme
• isSportGame(title), isBigBassGame(title), isTVAndMovie(title), isGameShow(title): Theme filters
• tvAndMovieSlots, gameShowSlots: Arrays of themed slot names

Utility Functions (src/utils.js)

• normalizeProvider(name): Normalize provider names for consistency
• waitForElement(selector, timeout): Wait for a DOM element to appear
• isGameFavoritedFromTile(tileDiv): Detect if a game is favorited from a tile element
• isUserLoggedIn(): Check if the user is logged in to Betfred

FAQ

Q: Can I use this extension on browsers other than Chrome?
A: Yes! This is a cross-browser extension that works on Chrome, Edge, Brave, Firefox, and other modern browsers. See the Installation section for browser-specific setup instructions.

Q: How do I reset or clear my game database?
A: Export your database, edit or clear the file, and re-import it. Or, remove the extension and reinstall to start fresh.

Q: What happens if I import a broken or empty database?
A: The extension will show a toast error and keep your previous data safe.

Q: How does the settings memory work?
A: The extension automatically saves your provider, min stake, and filter selections when you close the panel or use the random game button. These settings are restored every time you open the panel.

Q: Can I track my wins and game plays?
A: Yes! The extension automatically tracks game plays and you can manually log wins using the "Log Win" feature. View your statistics in the Stats section.

Q: How do I use the bulk remove/re-add feature?
A: Go to Other Settings and click "Bulk Remove" or "Bulk Re-Add". You can remove/restore games by keywords like "Baccarat", "Blackjack", etc.

Q: Is my data synced between browsers?
A: No, data is stored locally in your browser. Use export/import to move data between browsers.

Q: Is the extension accessible?
A: Yes! All modals and toasts use ARIA roles/labels and are keyboard/screen reader friendly.

Q: Can I customize the themes or add new filters?
A: Yes! You can extend the filters in filters.js and add new theme buttons in ui.js.



Happy gaming and enjoy the extension!