Skip to content

RL199/cupid-enhanced

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

200 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Cupid Enhanced Logo

Enhances the OkCupid platform for better usability and features.


πŸ“š Table of Contents

πŸ“– Project Overview

Cupid Enhanced is a Chrome extension that enhances the OkCupid experience by unlocking hidden features, improving the user interface, and providing better control over your dating experience. Built with modern JavaScript and a beautiful dark-themed popup interface, this extension gives you the premium features you deserve.

🎯 Features

πŸ”’ Privacy & Photos

  • πŸ‘οΈ Reveal Who Liked You - View clear, unblurred profile pictures of all users who viewed or liked you and sort the list
  • πŸ›‘ Set Dealbreakers - See only the people who meet your preferences
  • πŸ“· Photo Requirement Bypass - Unlock actions that normally require profile photos, such as sending likes and passes
  • πŸ’― Display Real Like Numbers - See your actual like count instead of "99+ interested"
  • πŸ“… Photo Dates - See when profile photos were uploaded on the discover page and fullscreen photo viewer
  • πŸ’Œ See All Intros - View all intro messages you've received
  • ❓ See All Question Answers - View all question answers on profiles
  • πŸ“Έ High Resolution Photo Upload - Upload high-resolution photos directly to your profile from the navigation bar (toggleable)
  • πŸ•΅οΈ Anonymous Message Read - Disable read receipts to read messages without sending notifications (toggleable)

🎨 Layout & Navigation

  • πŸ“ Better Discover Layout - Expanded page width with centered layout, photo dates, and likes remaining counter (toggleable)
  • πŸ’• Better Likes You Layout - Improved grid layout for the likes you page (toggleable)
  • πŸ–±οΈ Horizontal Scroll - Use mouse wheel to navigate through profiles on discover page and photos in fullscreen viewer
  • πŸ’˜ Like Indicator - See in the feed whether a profile has liked you or not
  • 🌐 Translate Essays - Translate profile essays in the feed using Google Translate
  • ❀️ Cupid's Picks Buttons - Add like and pass buttons to Cupid's Picks profiles for easier navigation
  • πŸ‘₯ Fetch All Interested Profiles - View all interested profiles including likes you, with the fetch button available in the navigation bar
  • πŸ’ž Interested Stack Action Buttons - Add like and pass buttons to profile stack cards in the "Interested in You" section after fetching profiles
  • πŸ•’ Recently Viewed Sort - Sort interested profiles by when they recently viewed or liked your profile
  • πŸ”” In-site Update Notifications - Get notified on OkCupid when a new extension version is available
  • 🚫 Hide Promotions - Clean interface without premium upgrade ads
  • πŸ† Premium Plus Badge - Display premium plus badge (visual only)
  • ⌨️ Shortcuts - Use Ctrl+Enter to send intro messages
  • βͺ Rewind - Enable the rewind button functionality
  • πŸ”§ Staff Mode - Access staff panel on the left sidebar (toggleable). Useful for accessing features like "Question Search" section.
  • πŸ™ˆ Reduced Interruptions - User guides and onboarding popups are hidden to avoid unnecessary interruptions

πŸŽ›οΈ Customization

  • βš™οΈ Settings Popup - Beautiful dark-themed popup with easy toggle controls for all features
  • πŸŒ™ Dark Mode - Experimental dark mode support
  • πŸ’Ύ Persistent Settings - Your preferences are saved and synced across sessions
  • πŸ”„ Partial Real-time Updates - Some changes apply instantly without requiring page reloads

βš™οΈ Installation

Prerequisites

  • Google Chrome or a Chromium-based browser, such as Edge or Opera.

Manual Installation (Developer Mode)

  1. Clone the repository or download the ZIP file from the latest release
  2. Extract the ZIP file to a directory on your computer.
  3. Open Chrome and navigate to chrome://extensions/.
  4. Enable "Developer mode" in the top right corner.
  5. Click "Load unpacked" and select the extension directory.
  6. The extension icon should now appear in your Chrome toolbar.

πŸ”§ Configuration

After installation, click the extension icon in your Chrome toolbar to open the settings popup. Available toggleable settings:

  • Staff Mode - Shows staff panel on the left sidebar. Useful for accessing features like the "Question Search" section.
  • Better Discover Layout - Expands page width and adds additional profile information
  • Better Likes You Layout - Displays likes you layout in a grid with more profiles
  • Anonymous Message Read - Blocks read receipts so messages stay unseen
  • Photo Upload Button - Shows a high resolution photo upload button in the site navigation bar
  • Dark Mode (Experimental) - Applies dark theme styling across all pages All settings are saved automatically. Most features work immediately, but some require a page refresh.

πŸ“Š Usage

  1. Navigate to OkCupid.com
  2. The extension runs automatically in the background
  3. Click the extension icon to customize which features you want enabled
  4. Use the navigation bar buttons to fetch interested profiles from any section and upload high-resolution photos (if enabled)
  5. If a new version is released, an in-site notification will let you know
  6. Enjoy an enhanced OkCupid experience with clearer images, real counts, and no ads!

πŸ“Έ Screenshots

Popup Page

The extension features a beautiful dark-themed popup with gradient colors matching the logo, providing easy access to all settings with toggle switches for each feature.

Cupid Enhanced Popup Screenshot

πŸ› οΈ Technical Details

Technologies Used

  • Chrome Extension Manifest V3 - Extension platform (service worker background model)
  • Service Worker (background.js) - Persistent background tasks and API requests
  • Vanilla JavaScript (ES2020+) - No external frameworks or runtime
  • Chrome Extension APIs - storage, tabs, cookies, action for settings, tab comms and authenticated requests
  • Content scripts (MAIN & isolated worlds) - DOM updates and an API interceptor injected into the page
  • GraphQL interception & Fetch API override - Intercepts OkCupid GraphQL responses (Response.prototype.text override)
  • Fetch API & background requests - Authenticated requests via background service worker
  • MutationObserver & DOM APIs - Real-time UI enhancements and element monitoring
  • Popup UI (HTML/CSS/JS) - Responsive dark-themed settings popup
  • No third‑party libraries - Small footprint; all processing happens client-side

Features Implementation

API Interception: The extension intercepts GraphQL API responses before OkCupid processes them, allowing modification of data like image URLs and like counts.

Response.prototype.text Override: By overriding the native Response.prototype.text() method in the MAIN world, we can intercept and modify API responses seamlessly.

Dynamic Settings: Settings are stored using chrome.storage.local and synchronized in real-time between the popup, content scripts, and API interceptor using message passing.

DOM Enhancement: MutationObservers watch for specific elements and apply enhancements like CSS modifications, element removal (ads), and content replacement.

πŸ—ΊοΈ Roadmap

Planned Features

  • πŸ“‚ Passed Profiles Archive - Access profiles you've passed on discover page
  • πŸ€– AI Intro Message Generator - Generate personalized intro messages using AI
  • πŸŒ‘ Enhanced Dark Mode - Full dark mode support across all OkCupid pages
  • ⌨️ Additional Keyboard Shortcuts - More navigation and action shortcuts
  • πŸ›’Chrome Web Store Publishing - Make the extension available for easy installation via the Chrome Web Store
  • 🦊 Cross-Browser Compatibility - Extend support to Firefox and other browsers
  • πŸ“Š Analytics Dashboard - Provide insights into your dating activity and extension usage
  • ⚑ Auto pass/like for Custom Filters - Automatically pass or like profiles based on user-defined criteria

See more in the Issues Section

πŸ” Privacy and Security

Your privacy is a priority. This extension:

  • βœ… Only runs on OkCupid.com domains
  • βœ… Does not collect or transmit any personal data
  • βœ… Does not track your browsing activity
  • βœ… All processing happens locally in your browser
  • βœ… Settings are stored locally using Chrome's storage API
  • βœ… Open source - you can review all code

Permissions

The extension requires the following permissions:

  • storage - To save your settings preferences locally
  • tabs - To communicate settings updates to active OkCupid tabs
  • cookies - To read OkCupid session cookies for authenticated API requests
  • Host Permission (https://www.okcupid.com/*) - To access core OkCupid pages
  • Host Permission (https://*.okcupid.com/*) - To run content scripts across OkCupid subdomains
  • Host Permission (https://e2p-okapi.api.okcupid.com/*) - To access OkCupid GraphQL API endpoints

❓ FAQs

Can I use this extension on other browsers?

The extension is designed for Chrome and Chromium-based browsers (Edge, Opera, Brave, etc.). It uses Manifest V3 which is supported by all modern Chromium browsers.

Is this extension safe to use?

Yes! The extension is completely open source and only modifies how OkCupid data is displayed to you. It doesn't collect any data or communicate with external servers. All processing happens locally in your browser.

Will using this extension get me banned?

This extension only modifies what you see in your browser. It doesn't perform automated actions, send fake data, or violate OkCupid's terms of service in ways that would be detectable. However, use at your own discretion.

How do I update the extension?

You'll need to download the latest release and reload it. Automatic updates will be available once published to the Chrome Web Store.

πŸ“ž Contact

For any inquiries, please contact thisisjustadeveloper@gmail.com.


About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors