customizing plan 9's acme

customizing plan 9's acme - Other *nix-like OSes & POSIX related

Users browsing this thread: 3 Guest(s)

	jmbi Offline \| 11-06-2014, 12:58 PM \| #1

<center><h2 style="margin-top: -10px; margin-bottom: -10px;">customizing acme</h2></center>
I've been putting off writing this thread, but I've finally mustered up enough motivation to do it for you guys. I know most of you have probably never used the **acme** editor, but hopefully after reading this you might change your mind. I'll start off with a little history to wet your panties. Acme was written by Rob Pike (aka our leader) in the 90's for the Plan 9 operating system. It has full UTF-8 support, runs on Linux, FreeBSD, OpenBSD, and NetBSD through <a href="http://swtch.com/plan9port/">plan9port</a>, is completely written in C, and has the unix philosophy written all over it. If that's not enough to get you going, I'm not sure what will. Here's one of acme's most notable users:

Some people would advocate for the preservation of acme's defaults (*cough* #cat-v *cough*). I am not one of those people. If you're not either, here are the steps I go through to ricing acme (this works on plan 9 natively too).

Step 1: download <a href="http://swtch.com/plan9port/">plan9port</a> or use your distro's ports / package manager (I know FreeBSD has both)
Step 2: compile and install (/usr/local/plan9/ is best), follow all instructions to set up your path 
Step 3: go ahead and run "acme" in your terminal, you will see something like this:

Step 4: navigate to /usr/local/plan9/src/cmd/acme/ (or where set your path + /src/cmd/acme)
Step 5: open up acme.c and navigate to line 964, it should look like:

Code:
/* Blue */

tagcols[BACK] = allocimagemix(display, DPalebluegreen, DWhite);

tagcols[HIGH] = allocimage(display, Rect(0,0,1,1), screen->chan, 1, DPalegreygreen);

tagcols[BORD] = allocimage(display, Rect(0,0,1,1), screen->chan, 1, DPurpleblue);

tagcols[TEXT] = display->black;

tagcols[HTEXT] = display->black;

/* Yellow */

textcols[BACK] = allocimagemix(display, DPaleyellow, DWhite);

textcols[HIGH] = allocimage(display, Rect(0,0,1,1), screen->chan, 1, DDarkyellow);

textcols[BORD] = allocimage(display, Rect(0,0,1,1), screen->chan, 1, DYellowgreen);

textcols[TEXT] = display->black;

textcols[HTEXT] = display->black;

Step 6: change these 10 lines to look like:

Code:
/* Blue */

tagcols[BACK] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">151210</font>FF);

tagcols[HIGH] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">8a776a</font>FF);

tagcols[BORD] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">12100f</font>FF);

tagcols[TEXT] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">8a776a</font>FF);

tagcols[HTEXT] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">222222</font>FF);

/* Yellow */

textcols[BACK] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">181512</font>FF);

textcols[HIGH] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">8a776a</font>FF);

textcols[BORD] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">12100f</font>FF);

textcols[TEXT] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">bea492</font>FF);

textcols[HTEXT] = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">222222</font>FF);

Note: the red strings above are the hex codes of the color that will be displayed, the same #ffffff codes that you use in your .Xdefaults My advice is that you play around with the colors to see what corresponds to what in the GUI, it's fun and you'll be able to better customize it in the future.
Step 7: change the color values accordingly
Step 8: now that you've changed the basic colors, it's time to change the remaining buttons, look at lines 1000 and 1005, they should look like:

Code:
tmp = allocimage(display, Rect(0,0,1,1), screen->chan, 1, DMedblue);

and

Code:
colbutton = allocimage(display, r, screen->chan, 0, DPurpleblue);

Step 9: change them just like before, filling in your desired hex colors

Code:
tmp = allocimage(display, Rect(0,0,1,1), RGBA32, 1, 0x<font color="red">949762</font>FF);

and

Code:
colbutton = allocimage(display, r, RGBA32, 1, 0x<font color="red">9f7155</font>FF);

Step 10: make sure you're in /usr/local/plan9/src/cmd/acme/ and run "mk install" to compile & overwrite the binaries
Step 11: run "acme" and see your new colors

So now that you've got your colors you're probably wondering how to change the ugly font that is enabled by default. You can do this with the -f command line argument, more information is <a href="http://swtch.com/plan9port/man/man4/fontsrv.html">here</a>. I won't go into much detail about that here, but I do have yrmt's gohufontmod11 converted for use in the 'fonts' folder of <a href="https://bitbucket.org/jmbi/scrots/src">my mercurial repo</a>. The command I use is: "acme -f fonts/gohu.font" for example.
Before you know it acme starts looking like a polished piece of software! Here is my end result:

Thanks for reading, I hope I can convince at least some of you to give acme a try. Ask any questions you have, I'll be happy to answer.

	venam Offline \| 11-06-2014, 01:06 PM \| #2

Awesome tutorial. I think it's the first real tutorial on the internet about ricing ACME.

	yrmt Offline \| 11-06-2014, 01:12 PM \| #3

Indeed, great article.

	jmbi Offline \| 11-06-2014, 01:38 PM \| #4

(11-06-2014, 01:06 PM)venam Wrote: Awesome tutorial. I think it's the first real tutorial on the internet about ricing ACME.

(11-06-2014, 01:12 PM)yrmt Wrote: Indeed, great article.

thanks muh nigs

	pranomostro Offline \| 01-10-2015, 12:53 PM \| #5

Very nice.
I always wanted to read the sam source code and write something like acmefs for sam.
Adding the scrollwheel to it and mouse1+mouse2=cut and mouse1+mouse3=paste would be nice to do, too.

So much to do, so little time.

View a Printable Version