colszowka-window_resizer 0.0.2 → 0.1.0

data/README.textile

@@ -1 +1,54 @@
-Todooo
+h1. Window Resizer
+
+This is a tool for resizing and positioning the active window in the X window system.
+
+h2. Usage
+<code>$ sudo gem install colszowka-window_resizer</code>
+
+Please note that you need to have the <code>wmctrl</code> package installed. On Debian-based systems, installing can be done with <code>sudo apt-get install wmctrl</code>
+
+For a list of available commands, type:
+<code>$ resize_current_window --help</code>
+
+h2. Examples
+
+Place window in the center of the screen, using 85% of available height and width (a.k.a. defaults):
+<code>resize_current_window</code>
+
+Place window at the left screen border, make it use full height and half width:
+<code>resize_current_window --left -x 0.5 -y 1.0</code>
+
+Place window in the upper right corner, make it use 50% height and width:
+<code>resize_current_window --top -x 0.5 -y 0.5</code>
+
+Place window in the upper right corner, make it use 50% height and width:
+<code>resize_current_window --top -x 0.5 -y 0.5</code>
+
+Place window in the lower right corner, make it use 50% height and width:
+<code>resize_current_window --bottom -x 0.5 -y 0.5</code>
+
+Place window centered at the bottom of the screen, make it use 50% height and 100% width:
+<code>resize_current_window --bottom -x 1.0 -y 0.5</code>
+
+h2. Keybindings in Gnome
+
+On my machines, I have the following key bindings set up:
+<pre>
+# Window resizer keybindings
+gconftool-2 --set /apps/metacity/keybinding_commands/command_9 --type string "/usr/bin/resize_current_window"
+gconftool-2 --set /apps/metacity/global_keybindings/run_command_9 --type string "<Alt><Shift>Down"
+gconftool-2 --set /apps/metacity/keybinding_commands/command_10 --type string "/usr/bin/resize_current_window --left -x 0.55 -y 1.0"
+gconftool-2 --set /apps/metacity/global_keybindings/run_command_10 --type string "<Alt><Shift>Left"
+gconftool-2 --set /apps/metacity/keybinding_commands/command_11 --type string "/usr/bin/resize_current_window --right --top -x 0.44 -y 0.45"
+gconftool-2 --set /apps/metacity/global_keybindings/run_command_11 --type string "<Alt><Shift>Up"
+gconftool-2 --set /apps/metacity/keybinding_commands/command_12 --type string "/usr/bin/resize_current_window --right --bottom -x 0.44 -y 0.45"
+gconftool-2 --set /apps/metacity/global_keybindings/run_command_12 --type string "<Alt><Shift>Right"
+</pre>
+
+You can run this set of commands in your command line (CAUTION: this will overwrite existing keybindings for the named commands!), and afterwards will be able to "tile" your current screen using <code><Alt><Shift>(Down|Left|Up|Right)</code>. Feel free to customize the settings to your needs :)
+
+To learn about keybindings in Gnome with <code>gconf-editor</code>, you can also have a look at: http://www.linuxformat.co.uk/wiki/index.php/Setting_Key_Bindings_in_GNOME
+
+h2. Copyright
+
+window_resizer is Copyright &copy; 2009 Christoph Olszowka, It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

data/bin/resize_current_window

@@ -11,8 +11,6 @@ opt_parser = OptionParser.new do |opts|
 
   opts.on("-x X", "--width-ratio X", Float, "Resize ratio for window width relative to screen resolution. Defaults to 0.85") do |x|
     options[:resize_factors][:x] = x
-    # Fall back to default
-    options[:resize_factors][:x] ||= 0.85
     # Show error if resize ratio is invalid
     if options[:resize_factors][:x] < 0.1 or options[:resize_factors][:x] > 1.0
       raise OptionParser::InvalidArgument, "Width resize ratio must be > 0.1 and <= 1.0"
@@ -21,8 +19,6 @@ opt_parser = OptionParser.new do |opts|
   
   opts.on("-y X", "--height-ratio X", Float, "Resize ratio for window height relative to screen resolution. Defaults to 0.85") do |y|
     options[:resize_factors][:y] = y
-    # Fall back to default
-    options[:resize_factors][:y] ||= 0.85
     # Show error if resize ratio is invalid
     if options[:resize_factors][:y] < 0.1 or options[:resize_factors][:y] > 1.0
       raise OptionParser::InvalidArgument, "Height resize ratio must be > 0.1 and <= 1.0"
@@ -45,6 +41,9 @@ opt_parser = OptionParser.new do |opts|
   # Fall back to centered positions of none given
   options[:positions][:x] ||= :center
   options[:positions][:y] ||= :center
+  # Fall back to defaults for resize factors if none given
+  options[:resize_factors][:x] ||= 0.85
+  options[:resize_factors][:y] ||= 0.85
 end
 
 # Parse options and exit on failure

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: colszowka-window_resizer
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  version: 0.1.0
 platform: ruby
 authors: 
 - Christoph Olszowka