https://github.com/scottlamb/netgrowler

displays on-screen notifications of network events on an OS X machine through the Growl framework
https://github.com/scottlamb/netgrowler

Last synced: 3 months ago
JSON representation

displays on-screen notifications of network events on an OS X machine through the Growl framework

• Host: GitHub
• URL: https://github.com/scottlamb/netgrowler
• Owner: scottlamb
• Created: 2014-09-30T05:14:39.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2014-09-30T05:42:53.000Z (almost 12 years ago)
• Last Synced: 2025-01-09T08:23:53.586Z (over 1 year ago)
• Language: Perl
• Size: 371 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.html
  • Changelog: CHANGES

Awesome Lists containing this project

README

          

  

    NetGrowler Readme

  

  

NetGrowler Readme


Introduction


This is NetGrowler

version 0.2.5-dev, which displays on-screen notifications of network

events (AirPort connect/disconnect, IP address changes, etc.) on an OS X

machine through the Growl framework.


NetGrowler is released under the MIT license, the full text of which is

below.


Installation and use


To start using NetGrowler:




Save NetGrowler.app somewhere, perhaps

    /Applications/Utilities.

Launch it. Just click.

Verify it's running by looking for it in the Activity Monitor's list of

    running applications or looking for its output in Console.app.

Verify it actually works by pulling the network cable or shutting down

    your airport. It should pop up a window when the network connections goes

    away.

Make it run on startup by going to Accounts within your System Preferences

    and adding it to your account's "Startup Items" tab.



Known Problems




It expects a Ethernet interface at "en0". If your system has only an

    AirPort, this might cause problems. (See the "XXX" in

    EthernetObserver.m.)



Feel free to fix these and

send patches.


If you find any other problems, please let

me know.


Future Enhancements


Here are some enhancements I'm thinking about:



I could make a SystemPreferences pane, so there's an easier way to see if

    it's running and start/stop it. It'd also be a place to

    put…preferences. See the next point.

I could add in a way to assign friendly names to wireless networks (as

    a mapping to BSSID internally). Then you'd be able to distinguish

    between all the networks named "linksys" without guessing or memorizing

    their BSSIDs.

I learned from

    this

    CocoaDev page how to get a lot more information on AirPort networks.

    Base speed (11Mbps or 54Mbps), signal strength, channel, etc.

    I don't want to clutter the screen too much, so I have to decide what's

    most useful.

I could add localization support. I'd need help with this, as English

    is the only language I speak well. I have noticed a lot of downloads

    from Japan. Anyone?

I could add support for noting when PPP links go up or down. (In fact,

    it's mostly done. See PPPObserver.m. It's not working well, though.)



You're welcome to send patches for new features, too.


Acknowledgements


The Growl team for providing the

notification framework NetGrowler uses.


Dustin Sallings, whose NetAlert was

the inspiration for this project. It displays a homegrown bezel on IP address

changes.


License


Copyright © 2004–2007 Scott Lamb <slamb@slamb.org>.


Permission is hereby granted, free of charge, to any person obtaining a

copy of this software and associated documentation files (the "Software"),

to deal in the Software without restriction, including without limitation

the rights to use, copy, modify, merge, publish, distribute, sublicense,

and/or sell copies of the Software, and to permit persons to whom the

Software is furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL

THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

DEALINGS IN THE SOFTWARE.