Git Product home page Git Product logo

gasmask's Introduction

Gas Mask

Build Status

Gas Mask is simple hosts file manager for macOS. It allows editing of host files and switching between them.

System requirements

Runs on Lion, Mountain Lion, Mavericks, Yosemite, El Capitan, Sierra, High Sierra and Mojave.

Download

Download latest version (0.8.6)

Installation

Drag the application from Downloads into Applications folder. The first time you launch it, it will ask for your password, because it needs escalated privilege to modify your /etc/hosts file.

How it works

Gas Mask monitors /etc/hosts system file and updates it with your activated hosts file.

Gas Mask stores your custom hosts files in ~/Library/Gas Mask directory.

Application log can be found in ~/Library/Logs/Gas Mask.log. Its worth having a look for errors in there when posting an issue.

User Guide

Gas Mask usually operates in the background. It adds a tray icon, where you can access the main editor window and quickly switch between hosts files.

The main editor consists of three parts: Toolbar, a list of your hosts files on the left, and file editor on the right. Initially you will have a single file called Original file under Local, which is a copy of your original /etc/hosts file.

To add new files, click Create(+) button in the toolbar and select the type of file (Local, Remote or Combined).

To remove a file, select it and press the Remove button in toolbar.

To activate a file, select it and press Activate button in toolbar, or select it from tray icon when the editor is hidden. Gas Mask will update the /etc/hosts file with the currently activated file. The active file is marked with a check in the editor list, and can also be displayed next to Gas Mask tray icon (Preferences > Show Host File Name in Status Bar)

Local files

These are ordinary local files that you can edit.

Remote files

These are files that Gas Mask downloads and synchronizes from remote URLs. You can adjust how often they sould update in Preferences, or force an update from tray icon. You cannot edit these files, as they are be overwriten by update.

  • NOTE the current version has a bug that allows remote files only from http:// sources (no https://)

Combined files

This is where Gas Mask shines compared to other hosts managers for MacOS. A combined file doesn't contain hosts entries, but a list of local and remote files.

Where to find hosts files

A great source of curated hosts files can be found at https://github.com/StevenBlack/hosts

Building Gas Mask

Gas Mask can be built with XCode 10.1

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.