aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--AUTHORS5
-rw-r--r--HOWTO6
-rw-r--r--README100
-rw-r--r--TODO6
-rw-r--r--config19
-rw-r--r--uzbl.c158
6 files changed, 199 insertions, 95 deletions
diff --git a/AUTHORS b/AUTHORS
index 5e79164..1484190 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1,6 +1,5 @@
-Alp Toker <alp@atoker.com>, Apple Inc - Original code taken from webkit example application, copyright 2006, 2007 Apple Inc and 2007 Alp Toker
-
-Dieter Plaetinck (Dieter@be) <http://dieter.plaetinck.be/> - Enhancements to form uzbl.
+Original code taken from webkit example application whis is copyrighted 2006, 2007 Apple Inc and 2007 Alp Toker <alp@atoker.com>
+enhancements to form uzbl made by Dieter Plaetinck.
Michael Walker (Barrucadu) <mike@barrucadu.co.uk> - Original threaded FIFO interface. Command adding methods.
diff --git a/HOWTO b/HOWTO
index f880552..d503cbd 100644
--- a/HOWTO
+++ b/HOWTO
@@ -1,5 +1,3 @@
-1) Checkout code.
+1) get the latest code from master branch
2) make
-3) make test
-4) ????
-5) PROFIT!
+3) profit ! \ No newline at end of file
diff --git a/README b/README
index 3a5d842..0c08b2c 100644
--- a/README
+++ b/README
@@ -1,26 +1,74 @@
-Control:
- - FIFO opened in /tmp/uzbl_pid
- - Commands are as follows:
- f - forward
- b - back
- r - refresh
- s - stop
- z+ - zoom in
- z- - zoom out
- - If a command is appended with a number, run it that many times (eg: z+10 would zoom in 10 times).
- - Press ESC to toggle the mode line.
- - Press enter after typing a command in the mode line to use it.
-
-Bugs:
- - Segfault occurs on shutdown, almost definitely FIFO related (I'm not seeing this bug now, but the warning was here when I forked the code and I haven't touched the FIFO bit)
- - Segfaults when using zoom commands (happens when max zoom already reached?).
-
-Notes:
- - I push the code most times I save any changes, regardless of whether it actually compiles or not. Thus, the code here should be regarded as highly experimental.
- - If you use any of my code in another fork of uzbl (or anything really) it'd be nice to get a mention.
-
-Todo:
- - Change commands to a few characters long.
- - Support for arguments to commands (argc/argv-like structure?).
- - Support for binding keyboard shortcuts in config file.
- - Support for setting home page in config file. \ No newline at end of file
+- Uzbl.
+ In my opinion, any program can only be really useful if it complies to the unix philosophy.
+ Web browsers are frequent violators of this principle. Time to change that!
+
+Right now uzbl is in a very early state but here are some ideas I would like to (not) implement
+
+- each instance of uzbl renders 1 page (eg it's a small wrapper around webkit), no tabbing, tab previews, or speed dial things. we have window managers for that.
+ -> well actually, there is lots of dicussion about this, i'll probably implement a basic form of tabbing.
+- simple ini config file ("profile") for keyboard, network,.. settings
+- implement some basic keyboard shortcuts for going up, down, refresh etc. preferably vim-like command style.
+- listen to signals and do useful stuff when triggered.
+- open up a socket file/fifo/.. so we can easily control each instance by writing things like 'uri <foo>' to /tmp/uzbl-windowid
+- MAYBE (if needed): 1 control application called uzblctrl or something. use this to modify the behavior of a uzbl instance (change url, refresh). use xdotool to get the window with focus. eg uzblctrl -win <id> -url <http://>.
+ use xbindkeys to bind keys to call uzblctrl.
+- no bookmark management builtin. make your own solution. for pulling a bookmark a plaintxt-based program using dmenu would work great here. combine with uzbltcrl and xbindkeys.
+ uzblctrl should support an option to query the current page so you can script something to add to your bookmarks. use zenity or something to add tags.
+- history: log 'Y-m-d H:M:S <url>' entries to a plaintext file. you can then use dmenu or whatever to select an entry and pipe the output to uzbl's fifo.
+- no ad blocking built in (I think).
+ alternatives:
+ -> /etc/hosts (not very good cause you need root and it affects the whole system)-> uzblctrl would need to support an option to list all images on a page, so you can easily pick the links to ads to add them to your /etc/hosts. (dmenu can again be great here to automate this)
+ -> privoxy looks cool and perfectly demonstrates the unix philosphy.
+- no download manager. allow user to pick wget/curl/a custom script/...
+- no build in command interpreters like ubiquity. uzbl should be accessible and you should use a shell or similar.
+- vimperator/konqueror-like hyperlink following.
+- password management. maybe an encrypted store that unlocks with an ssh key?
+- use the XDG basedir spec for separation of config, data and cache. and state will be a subdir in the config dir (not part of the spec yet) too.
+
+WIDGET ROADMAP:
+* statusbar? (the bar you see in pretty much every gtk program at the bottom. eg firefox)
+ consumes too much space (if always visible) for the little it is used. (+ you can put only 1 message in it at a time!)
+ -> option 1: no statusbar at all. when hovering over a link (or pressing key to preview the url without changing page) -> show url in tooltip on page.
+ -> option 2: toggle visibility of statusbar on/off when hovering over a link. since it's at the bottom I don't think it will disturb too much.
+* viewing progress/state of pageload? most programs use statusbar for this.
+ -> option 1: titlebar can show a percentage when it's loading a new page.
+ -> option 2: toggle a statusbar everytime we start loading a new page.
+* uri bar -> yes, even though we can write stuff to the fifo, it can still be convenient to change the url manually and stuff, so a widget in uzbl itself is good.
+* tabs -> yes. you don't have to use them, but you can.
+* back/forward/.. buttons? -> no: use keyboard shortcuts.
+* searching in a page? not sure.. maybe we can abuse the statusbar for that too.
+ eg toggle it on when the user wants to search for something and then do searching in some vim-like fashion.
+ we don't need a gtk text entry widget, just a feedback display of what the current command is.
+* scrollbar? no: use keyboard shortcuts. we should however have some info about the page length and where we are.
+ -> option 1: put a percentage in the window title
+ -> option 2: everytime you hit a key to change position, temporarily make a statusbar visible and put the percentage in the statusbar.
+ what will we do with pages who are too wide? horizontal scrolling?
+all of the above goes in 1 bar at the top of the program. there should be a key to toggle visibility of it and one to toggle visibilety + focus on the entrybar at once.
+
+input welcome!
+
+
+HISTORY FILE SIZE/PERFORMANCE
+each new pageload -> fopen(history_file, "a"), fwrite one line, fclose.
+I use utf8, so unless you use characters that are "special" (chinese etc)
+each character takes 1 byte.
+So, assume each entry is about 80 chars, you visit 100 pages per day (?), and you wonder when your history file will be 50MB big:
+(50 * 1000 * 1000 ) / ( 80 * 100 ) = 6250 days or 17 years.
+There is code to run a benchmark in the 'extra' dir. For results & interpretation, see http://dieter.plaetinck.be/poor_mans_dmenu_benchmark
+
+CONTROL:
+- FIFO opened in /tmp/uzbl_pid
+- See config file for commands
+- Press ESC to toggle the command entry.
+- Press enter after typing a command to use it.
+
+NOTE:
+- My c skills are very rusty, it will take me a while to get back up to speed
+- For more thoughts & ideas see http://bbs.archlinux.org/viewtopic.php?id=67463
+- I push the code most times I save any changes, regardless of whether it actually compiles or not. Thus, the code here should be regarded as highly experimental.
+
+KNOWN BUGS
+- Segfault occurs on shutdown, almost definitely FIFO related (I'm not seeing this bug now, but the warning was here when I forked the code and I haven't touched the FIFO bit)
+- Segfaults when using zoom commands (happens when max zoom already reached?).
+- Something in the FIFO code causes CPU usage to jump.
+- Segfaults when loading aliases from confgi file (currently aliases are defined in the code as a 'work-around'). \ No newline at end of file
diff --git a/TODO b/TODO
new file mode 100644
index 0000000..b4c70bf
--- /dev/null
+++ b/TODO
@@ -0,0 +1,6 @@
+* implement all the ideas from README
+* do not store the 'http://' part in the history file
+* improve commandline arguments
+
+* Support for arguments to commands (argc/argv-like structure?).
+* Support for binding keyboard shortcuts in config file.
diff --git a/config b/config
index e5766cb..fca8d83 100644
--- a/config
+++ b/config
@@ -1,8 +1,17 @@
# example uzbl config. in a real config, we should obey the xdg spec
-[keyboard]
-next=somekey
-
[behavior]
-history_file = /tmp/uzbl.history
-
+history_file = /tmp/uzbl.history
+
+[alias]
+b = back
+f = forward
+z+ = zoom in
+z- = zoom out
+r = refresh
+s = stop
+
+[bindings_internal]
+
+[bindings_external]
+
[network]
diff --git a/uzbl.c b/uzbl.c
index f47e533..576810e 100644
--- a/uzbl.c
+++ b/uzbl.c
@@ -51,7 +51,6 @@ static gchar* history_file;
static gchar* home_page;
static gchar* uri = NULL;
static gchar* fifodir = NULL;
-static gint mechmode = 0;
static char fifopath[64];
static bool modevis = FALSE;
@@ -59,7 +58,6 @@ static GOptionEntry entries[] =
{
{ "uri", 'u', 0, G_OPTION_ARG_STRING, &uri, "Uri to load", NULL },
{ "fifo-dir", 'd', 0, G_OPTION_ARG_STRING, &fifodir, "Directory to place FIFOs", NULL },
- { "mechmode", 'm', 0, G_OPTION_ARG_INT, &mechmode, "Enable output suitable for machine processing", NULL },
{ NULL }
};
@@ -72,6 +70,15 @@ struct command
static struct command commands[256];
static int numcmds = 0;
+struct alias
+{
+ char alias[256];
+ char command[256];
+};
+
+static struct alias aliases[256];
+static int numalias = 0;
+
static void parse_command(char*);
static bool parse_modeline (GtkWidget* mode, GdkEventKey* event)
@@ -168,35 +175,36 @@ static void parse_command(char *command)
{
int i = 0;
bool done = false;
- char* strtimes = NULL;
-
+ char *cmdstr = command;
void (*func)(WebKitWebView*);
- int times = 1;
- for (i = 0; i < numcmds && ! done; i++)
+ printf("Checking aliases\n");
+ for (i = 0; i < numalias && ! done; i++)
{
- if (!strncmp (command, commands[i].command, strlen (commands[i].command)))
+ if (!strncmp (cmdstr, aliases[i].alias, strlen (aliases[i].alias)))
{
- func = commands[i].func;
+ strcpy(cmdstr, aliases[i].command);
done = true;
-
- if (strlen (command) > strlen (commands[i].command))
- {
- strtimes = (char *) command + strlen (commands[i].command);
- printf("%s\n", strtimes);
- times = atoi (strtimes);
- }
}
}
- if(done)
+ done = false;
+ printf("Checking commands\n");
+ for (i = 0; i < numcmds && ! done; i++)
{
- int j;
- for (j = 0; j < times; j++)
+ if (!strncmp (cmdstr, commands[i].command, strlen (commands[i].command)))
{
- func (web_view);
+ func = commands[i].func;
+ done = true;
}
}
+
+ printf("Command identified as \"%s\"\n", cmdstr);
+
+ if (done)
+ {
+ func (web_view);
+ }
else
{
if (!strncmp ("http://", command, 7))
@@ -210,50 +218,60 @@ static void parse_command(char *command)
static void *control_fifo()
{
- if (fifodir) {
- sprintf(fifopath, "%s/uzbl_%d", fifodir, getpid());
- } else {
- sprintf(fifopath, "/tmp/uzbl_%d", getpid());
- }
-
- if (mkfifo (fifopath, 0666) == -1) {
- printf("Possible error creating fifo\n");
- }
-
- if (mechmode) {
- printf("%s\n", fifopath);
- } else {
- printf ("Opened control fifo in %s\n", fifopath);
- }
-
- while (true)
- {
- FILE *fifo = fopen(fifopath, "r");
- if (!fifo) {
- printf("Could not open %s for reading\n", fifopath);
- return NULL;
+ if (fifodir)
+ {
+ sprintf (fifopath, "%s/uzbl_%d", fifodir, getpid ());
+ }
+ else
+ {
+ sprintf (fifopath, "/tmp/uzbl_%d", getpid ());
}
- char buffer[256];
- memset(buffer, 0, sizeof(buffer));
- while (!feof(fifo) && fgets(buffer, sizeof(buffer), fifo)) {
- if (strcmp(buffer, "\n")) {
- buffer[strlen(buffer)-1] = '\0'; // Remove newline
- parse_command(buffer);
- }
+ if (mkfifo (fifopath, 0666) == -1)
+ {
+ printf ("Possible error creating fifo\n");
}
- }
- return NULL;
+ printf ("Opened control fifo in %s\n", fifopath);
+
+ while (true)
+ {
+ FILE *fifo = fopen(fifopath, "r");
+ if (!fifo)
+ {
+ printf("Could not open %s for reading\n", fifopath);
+ return NULL;
+ }
+
+ char buffer[256];
+ memset (buffer, 0, sizeof (buffer));
+ while (!feof (fifo) && fgets (buffer, sizeof (buffer), fifo))
+ {
+ if (strcmp (buffer, "\n"))
+ {
+ buffer[strlen (buffer) - 1] = '\0'; // Remove newline
+ parse_command (buffer);
+ }
+ }
+ }
+
+ return NULL;
}
static void add_command (char* cmdstr, void* function)
{
- strncpy(commands[numcmds].command, cmdstr, strlen(cmdstr));
+ strncpy (commands[numcmds].command, cmdstr, strlen (cmdstr));
commands[numcmds].func = function;
numcmds++;
}
+static void add_command_alias (char* alias, char* command)
+{
+ strncpy (aliases[numalias].alias, alias, strlen (alias));
+ strncpy (aliases[numalias].command, command, strlen (command));
+ numalias++;
+}
+
static bool setup_gtk (int argc, char* argv[])
{
gtk_init (&argc, &argv);
@@ -288,12 +306,12 @@ static void setup_commands ()
{
//This func. is nice but currently it cannot be used for functions that require arguments or return data. --sentientswitch
- add_command("b", &webkit_web_view_go_back);
- add_command("f", &webkit_web_view_go_forward);
- add_command("r", &webkit_web_view_reload); //Buggy
- add_command("s", &webkit_web_view_stop_loading);
- add_command("z+", &webkit_web_view_zoom_in); //Can crash (when max zoom reached?).
- add_command("z-", &webkit_web_view_zoom_out); //Crashes as zoom +
+ add_command("back", &webkit_web_view_go_back);
+ add_command("forward", &webkit_web_view_go_forward);
+ add_command("refresh", &webkit_web_view_reload); //Buggy
+ add_command("stop", &webkit_web_view_stop_loading);
+ add_command("zoom in", &webkit_web_view_zoom_in); //Can crash (when max zoom reached?).
+ add_command("zoom out", &webkit_web_view_zoom_out); //Crashes as zoom +
//add_command("get uri", &webkit_web_view_get_uri);
}
@@ -336,6 +354,32 @@ static void setup_settings ()
{
printf ("Home page disabled\n");
}
+
+ /*GError *error = 0;
+ char *keys = g_key_file_get_keys (config, "alias", NULL, &error);
+
+ if (error)
+ {
+ printf("Error: %n\n", error);
+ }
+ else
+ {
+ printf("Loading aliases\n");
+ while (keys != NULL && (*keys) != NULL)
+ {
+ char* value = g_key_file_get_value (config, (gchar *)"alias", (*keys), NULL);
+ add_command_alias((*keys), value);
+ ++keys;
+ }
+ }
+
+ Until segfaults is fixed, manually add aliases to test the rest of it. */
+ add_command_alias("b", "back");
+ add_command_alias("f", "forward");
+ add_command_alias("z+", "zoom in");
+ add_command_alias("z-", "zoom out");
+ add_command_alias("r", "refresh");
+ add_command_alias("s", "stop");
}
int main (int argc, char* argv[])