Commentary in job.scm that explains usage.
[tlb/tomd.git] / README
1 ABSTRACT
2
3 This project is a c/guile project built to manage Tom Balzer's POSIX
4 compliant systems. The daemon is written in C99, with extensions being
5 written in Guile.
6
7 DISCLAIMER
8
9 This is not supposed to be something new or novel - this is supposed
10 to give me complete control over the programs I run and the
11 configuration of my machines. I don't CARE that one or more tools can
12 provide all of the features I want. I WANT to do shit the way I want
13 to do them.
14
15 Also, I don't CARE if anything in this repository offends, including
16 language and jokes. If you complain, don't expect sympathy or action
17 on my part.
18
19 CONTACT
20
21 If you wish to contact me, niebieskitrociny@gmail.com is sufficient.
22
23 PURPOSE
24
25 I am tired of writing one off scripts to do core management duties,
26 and want everything to be directly under my control. Projected duties:
27
28 - Daemon management
29 - Terminal management
30 - Power management
31 - Window management
32 - Network management
33
34 DAEMON MANAGEMENT
35
36 I want something to monitor the daemons I want on my machines that
37 isn't total horse shit.
38
39 - Emacs
40 - Spoon (dwm status bar)
41 - Mail (mu, fetchmail)
42 - Music (rn just cmus, should move to mpvd?)
43 - xst (not implemented, but a server for this will be implemented and
44 needs managed.
45 - Guix? Nix?
46
47 TERMINAL MANAGEMENT
48
49 Since xst wants to implement a terminal server, I figure it should be
50 managed by something like this. It might be fun to try and implement
51 it in Guile, and if this is already setup to work with Guile
52 extensions it seems a natural place.
53
54 POWER MANAGEMENT
55
56 Right now I am using powertop and one off scripts that run on boot to
57 make sure my power settings are correct. I would rather have something
58 that automatically does:
59
60 - Custom profiles for A/C, Battery, Sleeping, etc.
61 - Automatic scripting on events
62
63 WINDOW MANAGEMENT
64
65 I use suckless.org's dwm, which is very small, fast, and easy to
66 use. But, I want to have somethings better integrated.
67
68 - Event driven updates of the status bar
69 + volume
70 + network
71 + time
72 + music
73 - preset layouts/programs on different tabs, layouts.
74 - arbitrary scripts, guile will do
75
76 NETWORK MANAGEMENT
77
78 I use a laptop without wireless, so I USB tether my phone to fill that
79 gap. I want to automatically start tethering on my phone and run the
80 corresponding commands on my machine when i plug it in.
81
82 - Android app?
83 - Detect plugin/plugout events
84 - Notify the status bar for status