Keylogger for mac written in Swift using HID
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Keylogger Update main Jul 6, 2018
LICENSE Initial commit Feb 1, 2017
README.md Add how to add keylogger to cocoa apps Jul 6, 2018

README.md

macOS Swift-Keylogger

Backers on Open Collective Sponsors on Open Collective Swift 4.0

It is a simple and easy to use keylogger for macOS. It is not meant to be malicious. There are only few keyloggers available for Mac and none of them are in Swift.

Another problem is with Apple high-level APIs. I don't know the reason but Apple suddenly deprecates and removes the documentation of APIs from its website.

So, I don't want to keep checking about the availability of their APIs and changing my code frequently. That is the reason I went for low-level API which is using HID API.

Most of the keyloggers available only log keystrokes into a file without much information about on which app the keystrokes are generated.

Usage

Clone the repository and open the project in Xcode and build the project and run the executable.

To run it in the background

To be able to close the Terminal when Keylogger is running, use this command while running the executable.

$ nohup ./Keylogger &

And you can quit the Terminal.

To quit/stop the Keylogger

To quit the Keylogger, first, find its PID using ps and use kill to stop the keylogger.

$ ps -e | grep "Keylogger"
$ kill -9 pid_of_keylogger_from_above_command

When it's run, it creates folder Data

|--Keylogger
|--Data
    |--App
    |--Devices
    |--Key

Key folder stores all the keystrokes according to application. App folder stores all the timestamps of applications being active. Devices folder stores the information about the connected keyboards.

By default, it creates a folder where the executable is present. To change the path edit bundlePathURL in Keylogger.swift

All the data is grouped according to day in each folder.

Integrating Swift-Keylogger with Cocoa App

There are 2 ways:

  1. Using the executable(By using Process to call the external binaries from Cocoa App).
  2. Using source code in your App without the need for external binary

Using executable

NOTE: The documentation of Apple has been constantly changing since the release of Swift. So, I just wanted to give the basic idea of this method without providing the code to avoid updating this part of the code frequently.

  1. Clone it and build the project by yourself or download the already built binary from the releases page.
  2. Use Process to run the external binary from your app.
  3. NOTE: Don't use waitUntilExit() or similar methods which can block the execution of the main UI to run the keylogger!

Using Source code

1. Add Keylogger.swift and CallBackFunctions.swift files to your project.

2. Initialize the Keylogger as a static variable and use start() and stop() to start and stop the keylogger.

Example of ViewController.swift

import Cocoa


class ViewController: NSViewController {

    // Initialize the Keylogger
    static var k = Keylogger()

    override func viewDidLoad() {
        super.viewDidLoad()

        // Do any additional setup after loading the view.
    }

    override var representedObject: Any? {
        didSet {
        // Update the view, if already loaded.
        }
    }

    // A button to start the keylogger
    @IBAction func start(_ sender: Any) {
        ViewController.k.start()
    }
    
    // A button to stop the keylogger
    @IBAction func stop(_ sender: Any) {
        ViewController.k.stop()
    }
}

3. Now, to run it without any problems, turn off the APP SANDBOX. If you want to use APP SANDBOX, then add the following to your entitlements:

com.apple.security.device.usb = YES

Disclaimer

If the use of this product causes the death of your firstborn or anyone, I'm not responsible ( no warranty, no liability, etc.)

For technical people: It is only for educational purpose.

Note: This keylogger doesn't capture secure input fields like passwords due to EnableSecureEventInput

Contributing

Feel free to fork the project and submit a pull request with your changes!

License

MIT

Free Software, Hell Yeah!

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]