Skip to content

Repository files navigation

⌨️ achroma - Browse and code with your keyboard

Download achroma

Achroma combines a web browser and a command-line terminal into one interface. It allows users to browse the internet and run technical commands without moving their hands from the keyboard. This design improves speed and focus by removing the need for a mouse.

📥 How to download and install

You can get the latest version of achroma through our releases page. Follow these steps to set up the software on your Windows computer:

  1. Visit this link to download.
  2. Look for the section labeled "Assets" at the bottom of the newest release post.
  3. Click the file that ends in ".exe" to begin the download.
  4. Save the file to your "Downloads" folder.
  5. Open your "Downloads" folder and double-click the file you just saved.
  6. Follow the prompts on your screen to finish the installation.

🚀 Getting started

Once the installation finishes, you will see an achroma icon on your desktop. Double-click this icon to start the application. The software opens a window that acts as both your browser and your terminal.

The top portion of the screen displays web content. The bottom portion provides a command prompt. You can switch between these two areas using the "Tab" key on your keyboard.

🛠️ Essential keyboard controls

Achroma relies on specific keys to manage your experience. Memorizing these commands makes navigation efficient.

  • Enter: Activates your selected link or runs the command you typed.
  • Tab: Moves your focus between the browser area and the terminal area.
  • Ctrl + T: Opens a new browser tab.
  • Ctrl + L: Moves your cursor to the address bar to type a new website.
  • Ctrl + W: Closes the current browser tab.
  • Alt + Left Arrow: Moves back to your previous webpage.
  • Alt + Right Arrow: Moves forward to the next webpage.

🌐 Using the browser features

The browser handles standard web navigation. You type website addresses directly into the address bar. If you want to search, type your query into the bar and press "Enter." Achroma loads the page exactly as a standard browser does. All links are clickable via keyboard shortcuts, but you can also focus on them by tabbing through the page elements.

💻 Working with the terminal

The terminal interface allows users to perform system tasks, manage files, or run scripts without leaving the application. To run a command, move your focus to the terminal area using the "Tab" key. Type your command and press "Enter."

The output of your command appears directly inside the terminal window. You can copy this output using "Ctrl + C" and paste it elsewhere using "Ctrl + V." This feature helps users who need to check network status, organize folders, or perform basic system maintenance while browsing.

⚙️ System requirements

Achroma runs on most modern Windows systems. To ensure smooth performance, verify your computer meets these minimum standards:

  • Operating System: Windows 10 or Windows 11.
  • Memory: At least 4 gigabytes of RAM.
  • Storage: 500 megabytes of free disk space.
  • Internet: A stable connection for browsing and updates.

🛡️ Privacy and security

Achroma does not track your browsing history or store your terminal commands on external servers. All data stays local to your machine. The browser uses current security standards to protect your connection to websites. You can clear your cache and cookies at any time through the settings menu found under "File" and "Preferences."

🧩 Customizing your experience

You can adjust how achroma looks and functions within the settings menu. Press "Ctrl + P" to open the preferences window. From here, you can choose a light or dark theme, change the font size for the terminal area, or set your default search engine. These changes take effect immediately after you save your choices.

🔍 Troubleshooting common issues

If you encounter problems, verify the following points:

  • App won't launch: Ensure your firewall or antivirus software does not block the application. You may need to add an exception for achroma in your security settings.
  • Slow performance: Close unused browser tabs. Each open tab consumes memory.
  • Terminal not responding: Press "Esc" to cancel any currently running command, then try to input the command again.
  • Update failures: Check your internet connection. If the app fails to update, you can manually download the latest version from the releases page and reinstall it over your existing version.

🤝 Getting help

If you experience persistent issues, check the "Issues" tab on the GitHub repository. You can search for existing reports to see if other users have faced similar problems. If you do not find a solution, open a new issue with a clear description of the error and the steps to reproduce it. Our community monitors these reports to provide support and improve the software over time.