Skip to content
master
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

xcode-wakatime

Coding time tracker

Xcode plugin to quantify your coding using https://wakatime.com/.

Note: Xcode8 disables plugins. Installing WakaTime re-signs Xcode.app with a self-signed cert.

Installation

  1. Run this Terminal command:
curl -fsSL https://raw.githubusercontent.com/wakatime/xcode-wakatime/master/install.sh | sh
  1. Restart Xcode.

  2. Enter your api key, then click OK. (Skip this step if you already have another WakaTime plugin)

  3. Use Xcode and your coding activity will be displayed on your WakaTime dashboard.

To install WakaTime for Xcode Beta, run this instead of step 1:

curl -fsSL https://raw.githubusercontent.com/wakatime/xcode-wakatime/master/install.sh | sh -s beta

To install WakaTime for Xcode where Xcode was installed to a non-standard folder:

curl -fsSL https://raw.githubusercontent.com/wakatime/xcode-wakatime/master/install.sh | sh -s custom /Path/To/Your/Xcode.app

To clone your Xcode.app to preserve the original app signature, run this instead of step 1:

curl -fsSL https://raw.githubusercontent.com/wakatime/xcode-wakatime/master/install.sh | sh -s copy

Screen Shots

Project Overview

Troubleshooting

First, do you see the Xcode → File → WakaTime API Key menu?

plugin menu

If you see that menu, it means the plugin was installed correctly and is running in Xcode... yay! Have a blank dashboard but see the plugin menu? Check your ~/.wakatime.log file for error messages.

If you don’t see that menu, try re-installing the plugin. That’s needed anytime Xcode.app is updated and generally solves most issues:

curl -fsSL https://raw.githubusercontent.com/wakatime/xcode-wakatime/master/install.sh | sh

If that doesn't work, turn on debug mode and check your wakatime cli log file (~/.wakatime.log).

If there are no errors in your ~/.wakatime.log file, check your Xcode log file (/var/log/system.log).

For more general troubleshooting information, see wakatime/wakatime#troubleshooting.

Uninstalling

To uninstall the WakaTime plugin, config file, and Alcatraz run these Terminal commands:

rm -r "${HOME}/Library/Application Support/Developer/Shared/Xcode/Plug-ins/WakaTime.xcplugin"
rm "${HOME}/.wakatime.cfg"
rm -r "${HOME}/Library/Application Support/Developer/Shared/Xcode/Plug-ins/Alcatraz.xcplugin"

The config file contains your API Key, so make sure to at least run the first two commands. Uninstalling Alcatraz is optional, and will prevent other non-WakaTime plugins from loading. After uninstalling, restart Xcode and you should no longer see WakaTime under the File menu.

About

Xcode plugin for automatic time tracking and metrics generated from your programming activity.

Topics

Resources

License

Packages

No packages published
You can’t perform that action at this time.