diff options
| -rw-r--r-- | README.md | 57 |
1 files changed, 35 insertions, 22 deletions
@@ -1,38 +1,51 @@ +<img align="left" src="https://user-images.githubusercontent.com/37427166/50706897-c9156380-1024-11e9-9619-85d66212410e.png" width="150" height="150"></img> + # dwa140shortcut -A shortcut menu bar application for macOS computers using the DWA-140 Utility. - +A simple menu bar application to expedite usage of the DWA-140 preference pane. This application is especially useful for users with a Hackintosh computer build. + +## Why dwa140shortcut? + +I created this application for personal use on my macOS machine that relies on the DWA-140 preference pane. It become a task opening System Preferences, opening the pane, waiting for it to load, and hoping that my connection would be successful. + +With this application, you are presented with a menubar icon that represents the current state of your network, as normal macOS also does. If you do not have a desirable network card, macOS doesn't give you the option to use the default WiFi menubar. + +If you're using a USB WiFi dongle on macOS, you're more than likely downloading a driver patch for your system. This patch usually routes traffic from the dongle to your ethernet controller, connecting you to the internet. + +## Features -## About -This project was written in Swift. This application was specifically designed for my (USB WiFi) Hackintosh build. This menu bar option shows the current connection status (through the icon) and has a few System Preferences shortcuts to expedite getting your machine connected to the internet. +* Easy "shortcut" button to the DWA-140 preference pane. +* Easy "shortcut" button to the Network Preferences preference pane. +* Ability to refresh the current status of your network connection. -## Requirements - - macOS 10.12+ with administrator privileges - -For 10.10 and 10.11 support, click [here](https://github.com/FivePixels/dwa140shortcut/issues/1#issuecomment-449897887). +## Installation -macOS <= 10.9 is unsupported. +## macOS 10.12+ Release -## Installation +* Download the latest release of the software from [here](https://github.com/FivePixels/dwa140shortcut/releases). -**Make sure you have the following installed prior to installing this application:** - - *RT2870USBWirelessDriver.kext* in /System/Library/Extensions/ - - *DWA-140WirelessUtility.prefPane* in either /Library/PreferencePanes/ or ~/Library/PreferencePanes/ +### **Make sure you have the following installed prior to installing this application:** ---- +* _RT2870USBWirelessDriver.kext_ in `/System/Library/Extensions/` +* _DWA-140WirelessUtility.prefPane_ in either `/Library/PreferencePanes/` or `~/Library/PreferencePanes/` -Download the latest DMG from the [Releases](https://github.com/fivepixels/dwa140shortcut/releases) page. -Open the DMG, and drag the application into the Applications folder. +### Setup +1. Open the `DWA140Menu.dmg` file. +2. Drag and drop the `DWA140Menu.app` contained within dmg into the Applications directory. +3. ??? +4. :tada: - +## Other macOS versions +Currently, I do not have full support for any version below macOS 10.12. I plan in the future to add full support but some of the frameworks I'm depending on only work above 10.12. -## Upcoming +I have created a specific version temporarily for 10.10 [here](https://github.com/FivePixels/dwa140shortcut/issues/1#issuecomment-449897887). -- [ ] *Automatically* add this application to Login Items -- [ ] Update menubar icon automatically -- [ ] Update menubar icon according to actual range from WiFi Network -- [ ] Perform a more realistic check for connection rather than just Ethernet +## Upcoming Features +- [ ] Toggle to enable application as soon as the user logs in. +- [ ] Update the menubar correctly, without needing to reload the application. +- [ ] Update the menubar accurately according to range. +- [ ] Perform a check to make sure the connection isn't captive, and if it is, present the user with an error letting them know. |