Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wakatime/xcode-wakatime
Xcode plugin for automatic time tracking and metrics generated from your programming activity.
https://github.com/wakatime/xcode-wakatime
time-tracking xcode xcode-plugin
Last synced: 5 days ago
JSON representation
Xcode plugin for automatic time tracking and metrics generated from your programming activity.
- Host: GitHub
- URL: https://github.com/wakatime/xcode-wakatime
- Owner: wakatime
- License: bsd-3-clause
- Created: 2014-03-13T07:39:31.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2023-06-18T16:37:59.000Z (over 1 year ago)
- Last Synced: 2024-12-30T13:34:28.675Z (12 days ago)
- Topics: time-tracking, xcode, xcode-plugin
- Language: Objective-C
- Homepage: https://wakatime.com/xcode
- Size: 170 KB
- Stars: 393
- Watchers: 20
- Forks: 28
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.rst
- License: LICENSE
Awesome Lists containing this project
README
xcode-wakatime
==============
## DEPRECATED: Use the [macos-wakatime](https://github.com/wakatime/macos-wakatime) repo instead.
[](https://wakatime.com/badge/github/wakatime/xcode-wakatime)
[WakaTime][wakatime] is an open source Xcode plugin for metrics, insights, and time tracking automatically generated from your programming activity.
**Note: Unfortunately, Apple has decided to stop loading plugins in Xcode 14. We currently have no way to get around this and no way to get the WakaTime plugin for Xcode working.**
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
```
2. Restart Xcode.
3. Enter your [api key](https://wakatime.com/settings#apikey), then click `OK`.
(Skip this step if you already have another WakaTime plugin)
4. Use Xcode and your coding activity will be displayed on your [WakaTime dashboard](https://wakatime.com).
Alternatively, to install WakaTime for Xcode without re-signing (so you can still publish to the App Store), run this instead of step 1:
```
sudo defaults write /Library/Preferences/com.apple.security.libraryvalidation.plist DisableLibraryValidation -bool true
curl -fsSL https://raw.githubusercontent.com/wakatime/xcode-wakatime/master/install.sh | sh -s nosign
```
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
```
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
```
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
```
Screen Shots
------------
Troubleshooting
---------------
First, do you see the `Xcode → File → WakaTime API Key` 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](https://github.com/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"
crontab -e
When crontab opens, remove the WakaTime line.
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.
[wakatime]: https://wakatime.com/xcode