Latest 0.1.0
License MIT
Platforms osx 10.9, requires ARC
Frameworks Cocoa


JMTimerBeam enables you to show a decent beam on your OSX screen for visualizing a timing event. The beam will be attached to the top, right, bottom or left side of your screen and decreases steadily depending on the amount of time already elapsed.


JMTimerBeam Top

JMTimerBeam Left


To create a new timer beam on your screen simply crete a new instance of JMTimerBeam with one of the following two methods:

/// Init new timer beam with given duration, orientation, thichkness and color
- (id) initWithDuration:(NSTimeInterval) duration
            orientation:(JMTimerBeamOrientation) orientation
              thickness:(NSInteger) thickness
                  color:(NSColor*) color;

/// Initialize a new JMTimerBeam positioned on the left of the screen 
/// with decent thickness and green color
- (id) initWithDuration:(NSTimeInterval) duration;

After that use the start and stop method to start/stop the beam respectively. For positioning the beam on the screen use one of the following orientations:

typedef enum JMTimerBeamOrientations {
} JMTimerBeamOrientation;

To get notified after the given duration elapsed and the beam ended implement the JMTimerBeamDelegate protocol with the method didFinishTimerBeam:.

To run the example project; clone the repo, and run pod install from the Project directory first.


JMTimerBeam is available through CocoaPods, to install
it simply add the following line to your Podfile:

pod "JMTimerBeam"


Andreas Katzian, JadeMind


JMTimerBeam is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "JMTimerBeam",
    "version": "0.1.0",
    "summary": "A decent timer beam displayed on top of your OSX screen.",
    "homepage": "",
    "license": "MIT",
    "authors": "Andreas Katzian",
    "source": {
        "git": "",
        "tag": "0.1.0"
    "platforms": {
        "osx": "10.9"
    "requires_arc": true,
    "source_files": "Classes",
    "frameworks": "Cocoa"

Pin It on Pinterest

Share This