readme.md 2.49 KB
Newer Older
Aral Balkan's avatar
Aral Balkan committed
1
2
3
4
5
6
# High Contrast I-Beam Cursor for Dark Xcode Themes 

Replaces the default, hard to spot, Xcode I-beam cursor (used to mark the position of the mouse when over text) with a sharp, high-constrast one.

_For use with dark themes only._

7
8
9
10
11
12
13
14
15
16
17
## Installation

### Quick

Copy the following into Terminal and press return:

```bash
git clone https://source.ind.ie/project/high-contrast-i-beam-cursor-for-dark-xcode-themes.git ind.ie.ibeam && cd ind.ie.ibeam && ./install && cd .. && rm -rf ind.ie.ibeam
```

### Manual
Aral Balkan's avatar
Aral Balkan committed
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

  1. ```./install```
  2. Enter your account password when asked by ```sudo```
  3. Restart Xcode

## Uninstalling

Run ```./install -o``` to revert to Xcode’s original cursor (as backed up from Xcode 6.1.1).

## Why?

I use the [EGOv2 theme](http://developers.enormego.com/view/ego_xcode_theme_for_xcode_4_egov2) in Xcode and the default dark I-beam is almost imperceptible.

### Original I-beam

33
![Original Xcode i-beam cursor on the EGOv2 theme](https://aralbalkan.com/images/old-ibeam.png)
Aral Balkan's avatar
Aral Balkan committed
34
35
36

### High-constrast I-beam

37
![High-contrast Xcode i-beam cursor on the EGOv2 theme.](https://aralbalkan.com/images/new-ibeam.png)
Aral Balkan's avatar
Aral Balkan committed
38
39
40
41
42
43
44
45
46
47
48

## Further accessibility

If the cursor is still hard to see, you can increase the system-wide cursor size via:

    System Preferences → Universal Access → Mouse & Trackpad → Cursor Size

When you do this, the original cursor will look blurry. So I’ve created two other sizes (medium; 32×32 pixel, and large; 64×64 pixel) that will look crisper. You can install those with ```./install -m``` and ```./install -l```, respectively.

(Thanks to Julian Richardson for [the tip](http://stackoverflow.com/a/7210916/253485).)

49
50
51
52
53
54
## Installing in Xcode beta

You can install the cursor in the Xcode beta instead of the release version of the app by running: 

	./install -b

Aral Balkan's avatar
Aral Balkan committed
55
56
57
58
59
60
61
62
63
## Limitations

This is not a smart cursor. It will remain white and become hard to use when, for example, you’re renaming a file in the Project Navigator on Xcode’s ambient light background. However, given how much time I spend editing code vs. editing text in other parts of the interface, it’s a tradeoff I’m happy to make.

Ideally, of course, Apple should implement a cursor that automatically adapts to the colour of the background.

## Credits and acknowledgements

This is based on [Better Xcode ibeam cursor](https://github.com/egold/better-xcode-ibeam-cursor) by Eric Goldberg, with thanks to [Chris Dragon](http://stackoverflow.com/a/12030806/253485). Released under the [MIT license](http://opensource.org/licenses/MIT).