Skip to content

Latest commit

 

History

History
81 lines (49 loc) · 5.28 KB

README.md

File metadata and controls

81 lines (49 loc) · 5.28 KB
Raw

WakaTime add-in for MonoDevelop / Xamarin Studio / Visual Studio for Mac

MonoDevelop Version XamarinStudio Version GitHub license GitHub top language Github all releases

Linux/macOS Builds via Travis CI Linux/macOS Builds via AppVeyor

WakaTime is a productivity & time tracking tool for programmers. Once the WakaTime plugin is installed, you get a dashboard with reports about your programming by time, language, project, and branch.

Downloads from the gallery:

macOS

Installation

The latests stable versions of WakaTime addin are available via GitHub Releases

Heads Up! WakaTime depends on Python being installed to work correctly. On macOS and Linux Python is usually pre-installed, while on Windows WakaTime tries to install automatically a portable version of Python.

  1. Inside MonoDevelop/Xamarin Studio/Visual Studio for Mac, navigate to Tools -> Add-in Manager

  2. Click the Install from file... button and browse to /path/to/monodevelop-wakatime/bin/Debug or DebugWin32 folder, depending on your OS and install MonoDevelop.WakaTime_x.x.mpack

  3. Click the Install button and then when add-in installation dialog popups click Install.

  4. On MonoDevelop/Xamarin Studio/Visual Studio for Mac versions prior to 5.10 you might get an error message, just ignore it, it's a Mono.Addin bug, it has been already solved in latest releases.

  5. Enter your api key from https://wakatime.com/settings#apikey, then click Apply button.

  6. You might have to restart your MonoDevelop/Xamarin Studio/Visual Studio for Mac

  7. Use MonoDevelop/Xamarin Studio/Visual Studio for Mac like you normally do and your time will be tracked for you automatically.

  8. Visit Wakatime Dashboard to see your logged time.

Installing via Addin Gallery

  1. Inside MonoDevelop/Xamarin Studio/Visual Studio for Mac, navigate to Tools -> Add-in Manager

  2. Click the Gallery tab, then search for wakatime.

  3. Click the Install button and follow the installation guide above starting from step #4.

Build & Install Manually

You can build and install this addin manually. On Linux you can skip the first step.

  1. Make make mdtool globally accessible.

    • On macOS open the Terminal and run the following command:
    sudo ln -sv /Applications/Xamarin Studio.app/Contents/MacOS/mdtool /usr/bin/
    • On Windows just add %ProgramFiles%"\Xamarin Studio\bin or %ProgramFiles(x86)%"\Xamarin Studio\bin append to PATH environment variable
    • On Linux mdtool is usually globally accessible, otherwise locate it and symlink it to /usr/local/bin/ or similar

  2. Just open the solution in MonoDevelop/Xamarin Studio/Visual Studio for Mac and build it using the appropriate configuration (Debug for Linux and macOS and DebugWin32 for Windows). Or use NuGet + XBuild / MSBuild in order to build it from the command-line:

nuget restore ./src
msbuild /p:Configuration=<Debug or DebugWin32 here> /t:Build ./src

  1. Inside MonoDevelop/Xamarin Studio/Visual Studio for Mac, navigate to Tools -> Add-in Manager

  2. Click the Install from file... button and browse to /path/to/monodevelop-wakatime/bin/Debug or DebugWin32 folder, depending on your OS and install MonoDevelop.WakaTime_x.x.mpack

  3. Click the Install button and follow the installation guide above starting from step #4.

Credits

Some code has been taken from Visual Studio WakaTime extension originally developed by WakaTime team. Hovewer that code has been heavily refactored, made cross-platform etc.

TODO

Try to port WakaTime to C# to avoid relying on Python