wuffl 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 46a0f50d3457bec156544cc167f04c2a712dfc8a4b4ea8cf80a17f8b5247d7f0
+  data.tar.gz: b5cdc53358c6cc5ab9e2b639c8ef4a4de365a680b3d5805cbd420ce6937f5e03
+SHA512:
+  metadata.gz: 64c69f5ee91b1282466a323d358f669407dbc7d27a29df5c3801922ff2fe93bde350ebed881c760d87672eb660c1a0cc5e05c58aacedd36c4b676fd9df45ed71
+  data.tar.gz: 97a5dbcedb88dba60a458d8bcfc2a5dd4d5e8a2b328101257018c578eb870a9e5435bef8e207bac52dd8e13ad6ef1b2e26f76a9381c315209eda7d26affcdd77

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Anna Foerster
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README

@@ -0,0 +1,34 @@
+# Wuffl
+<strong> 1. Introduction </strong>  
+Wuffl is a simple image viewer which can move pictures either to a „Selected“ folder or to a „Deleted“ folder. "Selected" and "Deleted" folders are located in the same folder as the chosen picture. Wuffl is available for Linux Ubuntu >=14.04, Mac and Windows.  
+
+Imagine you review you vacation photographs and you need to select which pictures to show to your friends at the next party or you work your way through a bunch of old pictures and you need to select a view of them for a anniversary celebration. Wuffl allows you to move the picture to an extra folder ("Selected" folder) or to a "Deleted" folder while viewing it. 
+<p>
+Source for the icons of the buttons: http://icons.mysitemyway.com  
+</p>
+<strong> 2. Installation </strong>  
+To use the Wuffl image viewer you require:
+<ul>
+  <li> <a href="https://www.ruby-lang.org/en/downloads/"><code>ruby</code></a> (v2.4)
+</ul>
+as well as the following Ruby gems:  
+<ul>
+  <li><code>fastimage</code>
+  <li><code>fileutils</code>
+  <li><code>gtk3</code>
+  <li><code>stringio</code></li>
+</ul>  
+
+Get the Wullf image viewer by typing ```gem install wuffl``` in your command line.
+
+<strong>3. Usage</strong>
+Using your terminal or cmd start Wuffl by typing  
+<code> wuffl</code>
+
+After starting Wuffl you'll see a start screen with a line of buttons at the bottom.  
+To select an image go to the top left corner, klick on <code>File</code> → <code>Open file</code> and browse to the location of you images. Then select an image and click <code>open</code> or just doubleclick on the selected image. 
+
+The buttons from left to right mean: <code>show previous image</code>, <code>rotate current image</code>, <code>move the current image to the folder 'Selected'</code>, <code>show next image</code>, <code>move the current image to the folder 'Deleted'</code>.
+
+<strong>4. Remarks</strong>  
+If you have any remarks, bugs, questions etc. please tell me, I'd be happy to help. 

data/bin/wuffl

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+require_relative '../lib/wuffl/wuffl_interface'
+
+int = Wuffl::WufflInterface.new
+
+int.run

data/lib/wuffl/actions.rb

@@ -0,0 +1,290 @@
+require_relative 'image_actions'
+
+module Wuffl
+  module Actions
+
+  	# get the operating system of the machine
+  	def self.get_op_sys
+      gempath = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+      gempath.sub!("/lib", "")
+  		if (/darwin/ =~ RUBY_PLATFORM) != nil
+  			return 'mac'
+  		elsif (/linux/ =~ RUBY_PLATFORM) != nil
+  			return 'linux'
+  		elsif (/cygwin|mswin|mingw|bccwin|wince|emx/ =~ RUBY_PLATFORM) != nil
+  			return 'windows'
+  		end
+  	end
+
+  	# get the resolution of the display
+  	def self.get_resolution
+
+      operating_system = get_op_sys
+
+  		case operating_system
+  			
+  		when 'windows'
+  			output_dimensions = `wmic path Win32_VideoController get VideoModeDescription,CurrentVerticalResolution,CurrentHorizontalResolution /format:value`
+        begin_hor_res = output_dimensions.index("HorizontalResolution")
+        begin_ver_res = output_dimensions.index("VerticalResolution")
+        begin_video_mode = output_dimensions.index("VideoMode")
+        length_hor = "HorizontalResolution=".length
+        length_ver = "VerticalResolution=".length
+        length_video = "VideoMode=".length
+        char_hor = output_dimensions[begin_hor_res + length_hor]
+        char_ver = output_dimensions[begin_ver_res + length_ver]
+        char_video = output_dimensions[begin_video_mode + length_video]
+        if char_hor != char_hor.to_i.to_s
+          output_dimensions.sub!("HorizontalResolution", "")
+        end
+        if char_ver != char_ver.to_i.to_s
+          output_dimensions.sub!("VerticalResolution", "")
+        end
+        if char_video != char_video.to_i.to_s
+          output_dimensions.sub!("VideoMode", "")
+        end
+
+  			# Horizontal Resolution of the screen
+  			hor_res_begin_index = output_dimensions.index("HorizontalResolution") + "HorizontalResolution=".length
+  			hor_res_end_index = output_dimensions.index("CurrentVertical") - 3
+  			win_width = output_dimensions.slice(hor_res_begin_index..hor_res_end_index).to_i
+
+  			# Vertical Resolution of the screen
+  			ver_res_begin_index = output_dimensions.index("VerticalResolution") + "VerticalResolution=".length
+  			ver_res_end_index = output_dimensions.index("VideoMode") - 3
+  			win_height = output_dimensions.slice(ver_res_begin_index..ver_res_end_index).to_i
+
+  		else
+  			if operating_system == "mac"
+  				output_dimensions = `system_profiler SPDisplaysDataType |grep Resolution`.chomp.tr(" ", "")			
+  				end_index = output_dimensions.index("Retina") - 1
+  			elsif operating_system == "linux"
+  				output_dimensions = `xdpyinfo | grep dimensions`.chomp.tr(" ", "")
+  				end_index = output_dimensions.index("p") - 1
+  			end
+  			start_index = output_dimensions.index(":") + 1
+  			resolution = output_dimensions.slice(start_index..end_index)
+  			win_width = resolution.slice(0..resolution.index("x")-1).to_i
+  			win_height = resolution.slice(resolution.index("x")+1.. resolution.length-1).to_i
+  		end	
+
+  		return [win_width, win_height]
+  	end
+
+    # pack the boxes for the GUI
+  	def self.pack_boxes(window, img_current, box_set, button_set)
+      box_set[:hbox].add button_set[:prev_btn]
+      box_set[:hbox].add button_set[:select_btn]
+      box_set[:hbox].add button_set[:rotate_btn]
+      box_set[:hbox].add button_set[:delete_btn]
+      box_set[:hbox].add button_set[:next_btn]
+      
+      box_set[:halign].add box_set[:hbox]
+
+      box_set[:vbox].pack_start box_set[:mb], :expand => false, :fill => false, :padding => 5
+      box_set[:vbox].pack_start img_current, :expand => true, :fill => true, :padding => 5
+      box_set[:vbox].pack_start box_set[:halign], :expand => false, :fill => false, :padding => 5   
+      
+
+      window.add box_set[:vbox]
+
+      return box_set
+    end
+
+  	# set the index for the next image
+  	def self.set_next_index(index, img_array)
+  		if (index + 1) <= (img_array.length - 1)
+  			index += 1
+  		else
+  			index = 0
+  		end
+  		return index
+  	end
+
+  	# set the index for the previous image
+  	def self.set_prev_index(index, img_array)
+  		if (index - 1) < 0
+  			index = img_array.length - 1
+  		else
+  			index -= 1
+  		end
+  		return index
+  	end
+
+    # deactivate all buttons
+  	def self.deactivate_buttons (button_set)
+      button_set.each do |button, sens_value|
+        button_set[button].sensitive = false
+      end
+  	end
+
+    # action when the "Open file" menu option is clicked
+    def self.open_file_action(window, img_parameters, button_set)
+      dialog = Gtk::FileChooserDialog.new(:title => "Open file", :parent => window, :action => Gtk::FileChooserAction::OPEN, 
+          :buttons => [[Gtk::Stock::OPEN, Gtk::ResponseType::ACCEPT], [Gtk::Stock::CANCEL, Gtk::ResponseType::CANCEL]])
+
+      if dialog.run == Gtk::ResponseType::ACCEPT
+        filename = dialog.filename
+        img_parameters[:dir_path] = File.dirname(filename)
+        img_parameters[:selected_path] = img_parameters[:dir_path] + "/Selected"
+        img_parameters[:deleted_path] = img_parameters[:dir_path] + "/Deleted"
+        all_files = Dir.entries(img_parameters[:dir_path])
+        accepted_formats = [".jpg", ".JPG", ".png", ".PNG", ".gif", ".GIF"]
+        img_parameters[:is_landscape] = true
+        
+        all_files.each do |name|
+          if accepted_formats.include? File.extname(name)
+            img_parameters[:all_orig_img] << name
+          end
+        end
+        img_parameters[:all_orig_img] = img_parameters[:all_orig_img].sort
+        just_the_name = File.basename filename
+
+        img_parameters[:all_orig_img].each_with_index do |name, index|
+          if just_the_name == name
+            img_parameters[:ind] = index
+          end
+        end
+
+        if File.directory?(img_parameters[:selected_path]) == false
+          Dir.mkdir(img_parameters[:selected_path])
+          FileUtils.chmod 0777, img_parameters[:selected_path]
+        end
+
+        if File.directory?(img_parameters[:deleted_path]) == false
+          Dir.mkdir(img_parameters[:deleted_path])
+          FileUtils.chmod 0777, img_parameters[:deleted_path]
+        end
+
+        # Prebuffer of all files
+        img_parameters[:all_orig_img].each do |file|
+          current_filename = img_parameters[:dir_path] + "/" + file
+          if current_filename.include?("\\")
+            current_filename.gsub!("\\", "/")
+          end
+          img_parameters[:all_orig_pb], img_parameters[:is_landscape] = ImageActions.prepare_pixbuf(current_filename, img_parameters[:all_orig_pb], img_parameters[:img_max_w], img_parameters[:img_max_h], img_parameters[:reduction_factor])
+        end
+        img_parameters[:pb_current] = img_parameters[:all_orig_pb][img_parameters[:ind]]
+
+        ImageActions.show_img(img_parameters[:img_current], img_parameters[:pb_current])
+        window.set_title File.basename filename
+
+        # Activate all buttons
+        button_set.each do |button, sens_value|
+          button_set[button].sensitive = true
+        end
+
+      end
+      dialog.destroy
+
+      return img_parameters
+    end
+
+    # action when the "previous image" button or the "next image" button is clicked
+    def self.prev_next_btn_action(window, img_parameters, previous_or_next_button)
+      if previous_or_next_button == "prev" # previous image
+        img_parameters[:ind] = set_prev_index(img_parameters[:ind], img_parameters[:all_orig_img])
+      elsif previous_or_next_button == "next" # next button
+        img_parameters[:ind] = set_next_index(img_parameters[:ind], img_parameters[:all_orig_img])
+      end    
+      filename = img_parameters[:dir_path] + "/" + img_parameters[:all_orig_img][img_parameters[:ind]]
+      img_parameters[:is_landscape] = ImageActions.img_dimensions_fi(filename)[0]
+      img_parameters[:pb_current] = img_parameters[:all_orig_pb][img_parameters[:ind]]
+      ImageActions.show_img(img_parameters[:img_current], img_parameters[:pb_current])
+      window.set_title File.basename filename
+
+      return img_parameters
+    end
+
+    # action when the rotate button is clicked
+    def self.rotate_btn_action(img_parameters)
+      if img_parameters[:is_landscape] == false # Original image in portrait format
+        img_parameters[:pb_current] = img_parameters[:pb_current].rotate(:clockwise)
+        
+      else # Original image in landscape format
+        if img_parameters[:rotation_case] == 'A'
+          img_parameters[:pb_current] = img_parameters[:pb_current].rotate(:clockwise)
+          width_pb = img_parameters[:pb_current].width
+          height_pb = img_parameters[:pb_current].height
+          if height_pb > img_parameters[:img_max_h]
+            while height_pb > img_parameters[:img_max_h] do 
+              height_pb *= img_parameters[:reduction_factor]
+              width_pb *= img_parameters[:reduction_factor]
+            end
+            height_pb = height_pb.to_i
+            width_pb = width_pb.to_i
+            img_parameters[:pb_portrait] = img_parameters[:pb_current].scale(width_pb, height_pb, :bilinear)
+            img_parameters[:pb_current] = img_parameters[:pb_portrait]
+          else
+            img_parameters[:pb_portrait] = img_parameters[:pb_current]
+          end
+          img_parameters[:rotation_case] = 'B'
+
+        elsif img_parameters[:rotation_case] == 'B'
+          img_parameters[:pb_current] = img_parameters[:all_orig_pb][img_parameters[:ind]].rotate(:upsidedown)
+          img_parameters[:rotation_case] = 'C'
+
+        elsif img_parameters[:rotation_case] == 'C'
+          img_parameters[:pb_current] = img_parameters[:pb_portrait].rotate(:upsidedown)
+          img_parameters[:rotation_case] = 'D'
+
+        elsif img_parameters[:rotation_case] == 'D'
+          img_parameters[:pb_current] = img_parameters[:all_orig_pb][img_parameters[:ind]]
+          img_parameters[:rotation_case] = 'A'
+        end
+      end
+      img_parameters[:img_current].set_pixbuf(img_parameters[:pb_current])
+
+      return img_parameters
+    end
+    
+    # action for the select and delete buttons
+    def self.select_delete_btn_action(window, img_parameters, button_set, select_delete_par)
+      if img_parameters[:all_orig_img].length > 0
+
+        just_the_name = img_parameters[:all_orig_img][img_parameters[:ind]]
+        current_location = img_parameters[:dir_path] + "/" + just_the_name
+        if select_delete_par == "select"
+          new_location = img_parameters[:selected_path] + "/" + just_the_name
+        elsif select_delete_par == "delete"
+          new_location = img_parameters[:deleted_path] + "/" + just_the_name
+        end
+        FileUtils.mv(current_location, new_location) 
+
+        img_parameters[:all_orig_img].delete_at(img_parameters[:ind])
+        img_parameters[:all_orig_pb].delete_at(img_parameters[:ind])
+
+        if img_parameters[:all_orig_img].length > 0
+          if img_parameters[:ind] == img_parameters[:all_orig_img].length
+            img_parameters[:ind] -= 1
+          end
+
+          just_the_name = img_parameters[:all_orig_img][img_parameters[:ind]]
+          filename = img_parameters[:dir_path] + "/" + just_the_name
+          img_parameters[:is_landscape] = ImageActions.img_dimensions_fi(filename)[0]
+          img_parameters[:pb_current] = img_parameters[:all_orig_pb][img_parameters[:ind]]
+          ImageActions.show_img(img_parameters[:img_current], img_parameters[:pb_current])
+          window.set_title just_the_name
+
+          if select_delete_par == "select"
+            # Buffer the next image if not all loaded yet
+            if img_parameters[:all_orig_pb].length != img_parameters[:all_orig_img].length
+              current_filename = img_parameters[:dir_path] + "/" + img_parameters[:all_orig_img][img_parameters[:ind]+1]
+              img_parameters[:all_orig_pb], img_parameters[:is_landscape]  = ImageActions.prepare_pixbuf(current_filename, img_parameters[:all_orig_pb], img_parameters[:img_max_w], img_parameters[:img_max_h], img_parameters[:reduction_factor])
+            end
+          end
+        else
+          img_parameters[:pb_current] = GdkPixbuf::Pixbuf.new
+          img_parameters[:img_current].set_pixbuf(img_parameters[:pb_current])
+          deactivate_buttons(button_set)
+        end
+      else
+        img_parameters[:pb_current] = GdkPixbuf::Pixbuf.new
+        img_parameters[:img_current].set_pixbuf(img_parameters[:pb_current])
+        deactivate_buttons(button_set)
+      end
+        return img_parameters
+    end
+
+  end
+end  

data/lib/wuffl/basic_elements.rb

@@ -0,0 +1,109 @@
+module Wuffl
+  module BasicElements
+
+    # define the interface window
+    def self.define_window(win_width, win_height)
+      window = Gtk::Window.new
+      window.set_title "Wuffl"
+      window.set_window_position :center
+      window.set_default_size win_width, win_height
+      window.signal_connect("destroy") {Gtk.main_quit}
+
+      return window
+    end
+
+    # define the boxes which are parts of the window
+    def self.define_boxes
+      vbox = Gtk::Box.new :vertical, 5
+      hbox = Gtk::Box.new :horizontal, 10
+
+      return [vbox, hbox]
+    end
+
+    # define the pixel buffers
+    def self.define_pixbuf
+      pb_current = GdkPixbuf::Pixbuf.new #current pixbuf
+      pb_portrait = GdkPixbuf::Pixbuf.new #pixbuf in portrait format (relevant only for rotations)
+
+      return [pb_current, pb_portrait]
+    end
+
+    # define the necessary buttons
+    def self.define_buttons
+      #-----------Definition of Buttons ----------
+
+      #-----------Previous-Button----------------------
+      prev_btn = Gtk::Button.new 
+      prev_btn.label = "Previous"
+      prev_btn.set_tooltip_text "Previous image"
+      prev_btn.sensitive = false
+
+      #-----------Next-Button-----------------------
+      next_btn = Gtk::Button.new
+      next_btn.label = "Next"
+      next_btn.set_tooltip_text "Next image"
+      next_btn.sensitive = false
+
+      #-----------Rotate-Button----------------------
+      rotate_btn = Gtk::Button.new
+      rotate_btn.label = "Rotate"
+      rotate_btn.set_tooltip_text "Rotate image"
+      rotate_btn.sensitive = false
+
+      #-----------Select-Button-----------------
+      select_btn = Gtk::Button.new
+      select_btn.label = "Move to \"Selected\""
+      select_btn.set_tooltip_text "Move the image to the \"Selected\" folder"
+      select_btn.sensitive = false
+
+      #-----------Delete-Button---------------------
+      delete_btn = Gtk::Button.new
+      delete_btn.label = "Move to \"Deleted\""
+      delete_btn.set_tooltip_text "Move the image to the \"Deleted\" folder"
+      delete_btn.sensitive = false
+
+      return {prev_btn: prev_btn, next_btn: next_btn, rotate_btn: rotate_btn, select_btn: select_btn, delete_btn: delete_btn}
+    end
+
+    # define the menu
+    def self.define_menu
+      mb = Gtk::MenuBar.new
+      file = Gtk::MenuItem.new :label => "File"
+      filemenu = Gtk::Menu.new
+      file.set_submenu filemenu
+
+      open_file = Gtk::MenuItem.new :label => "Open file"
+      quit = Gtk::MenuItem.new :label => "Exit"
+
+      filemenu.append open_file
+      filemenu.append quit
+      mb.append file
+
+      return [mb, open_file, quit]
+    end
+
+    # define the image parameters
+    def self.define_img_parameters(win_width, win_height, img_current)
+      pb_current, pb_portrait = define_pixbuf
+
+      img_parameters = {
+        dir_path: "", # path of the image folder
+        selected_path: "", 
+        deleted_path: "", 
+        name: "",
+        rotation_case: 'A',
+        ind: 0,      
+        is_landscape: true, 
+        all_orig_img: [],
+        all_orig_pb: [],
+        pb_current: pb_current,
+        pb_portrait: pb_portrait,
+        img_current: img_current, # current image
+        img_max_w: (win_width * 0.37).to_i, # max width for each image
+        img_max_h: (win_height * 0.37).to_i , # max height for each image
+        reduction_factor: 0.95
+      }
+      return img_parameters
+    end
+  end
+end

data/lib/wuffl/image_actions.rb

@@ -0,0 +1,90 @@
+module Wuffl 
+  module ImageActions
+
+    # determine the dimensions of the given image with FastImage-gem
+    def self.img_dimensions_fi (filename) 
+      img_dim = FastImage.size("#{filename}") 
+      img_orig_width_fi = img_dim[0]
+      img_orig_height_fi = img_dim[1]
+
+      if img_orig_width_fi > img_orig_height_fi
+        is_orig_landscape = true
+      else
+        is_orig_landscape = false
+      end
+
+      fastimage_infos = [is_orig_landscape, img_orig_width_fi.to_i, img_orig_height_fi.to_i]
+    end
+
+    # resize the image if too big - for landscape mode
+    def self.landscape_pic(pb_orig, img_width, img_height, img_max_w, img_max_h, reduction_factor)
+      if img_width > img_max_w || img_height > img_max_h
+          while img_width > img_max_w || img_height > img_max_h do
+            img_width *= reduction_factor
+            img_height *= reduction_factor
+          end
+      end
+
+      img_width = img_width.to_i
+      img_height = img_height.to_i
+      pb_orig = pb_orig.scale(img_width, img_height, :bilinear)
+      return pb_orig
+    end
+
+    # resize the image if too big - for portrait mode
+    def self.portrait_pic(pb_orig, rotate_pic, img_width, img_height, img_max_h, reduction_factor)
+      if rotate_pic == true
+        pb_orig = pb_orig.rotate(:clockwise)
+        z = img_width
+        img_width = img_height
+        img_height = z
+      end
+
+      if img_height > img_max_h
+        while img_height > img_max_h do
+          img_width *= reduction_factor
+          img_height *= reduction_factor
+        end
+      end 
+      
+        img_height = img_height.to_i
+        img_width = img_width.to_i
+
+        pb_orig = pb_orig.scale(img_width, img_height, :bilinear)
+        return pb_orig
+    end
+
+    # prepare image for loading
+    def self.prepare_pixbuf(filename, array_of_orig_pixbufs, img_max_w, img_max_h, reduction_factor)
+      fi_infos = img_dimensions_fi(filename)
+      pixbuf_infos = GdkPixbuf::Pixbuf.get_file_info(filename)
+      is_landscape = fi_infos[0]
+      pixbuf_width = pixbuf_infos[1]
+      pixbuf_height = pixbuf_infos[2]
+
+      img_width = pixbuf_width
+      img_height = pixbuf_height
+
+      pb_orig = GdkPixbuf::Pixbuf.new :file => filename, :width => img_width, :height => img_height
+      if fi_infos[1] > fi_infos[2] #landscape format
+        pb_orig = landscape_pic(pb_orig, img_width, img_height, img_max_w, img_max_h, reduction_factor)
+      else #portrait format
+        if (fi_infos[1] == pixbuf_infos[1]) && (fi_infos[2] == pixbuf_infos[2])
+          rotate_pic = false
+        else
+          rotate_pic = true
+        end 
+        pb_orig = portrait_pic(pb_orig, rotate_pic, img_width, img_height, img_max_h, reduction_factor)
+      end
+
+      array_of_orig_pixbufs << pb_orig
+      return [array_of_orig_pixbufs, is_landscape]
+    end
+
+    # display the current image
+    def self.show_img(img_curr, pb_curr)
+      img_curr.set_pixbuf(pb_curr)
+      
+    end
+  end
+end

data/lib/wuffl/wuffl_interface.rb

@@ -0,0 +1,88 @@
+require 'gtk3'
+require 'fileutils'
+require 'fastimage'
+require 'stringio'
+require_relative 'basic_elements'
+require_relative 'actions'
+
+module Wuffl
+
+  class WufflInterface
+
+    def initialize
+
+      # get the screen resolution
+      @win_width, @win_height = Actions.get_resolution
+
+      # define the window
+      @window = BasicElements.define_window(@win_width*0.45, @win_height*0.45)
+
+      # define the boxes
+      @vbox, @hbox = BasicElements.define_boxes
+
+      # prepare the current image
+      @img_current = Gtk::Image.new
+
+      @halign = Gtk::Alignment.new 0.5, 0, 0, 0
+
+      # define image parameters
+      @img_parameters = BasicElements.define_img_parameters(@win_width, @win_height, @img_current)
+
+      # define buttons
+      @button_set = BasicElements.define_buttons
+
+      # define menu
+      @mb, @open_file, @quit = BasicElements.define_menu
+
+      # define the set for the packing of boxes
+      @box_set = {hbox: @hbox, vbox: @vbox, halign: @halign, mb: @mb}
+
+
+    end
+
+
+    def run
+
+      # open file action
+      @open_file.signal_connect("activate") do |w|
+        @img_parameters = BasicElements.define_img_parameters(@win_width, @win_height, @img_current)
+        @img_parameters = Actions.open_file_action(@window, @img_parameters, @button_set)
+      end
+
+      # previous button action
+      @button_set[:prev_btn].signal_connect("clicked") do 
+        @img_parameters = Actions.prev_next_btn_action(@window, @img_parameters, "prev")
+      end
+
+      # next button action
+      @button_set[:next_btn].signal_connect("clicked") do   
+        @img_parameters = Actions.prev_next_btn_action(@window, @img_parameters, "next")  
+      end
+
+      # rotate button action
+      #----------------Rotate-Button------------------
+      @button_set[:rotate_btn].signal_connect("clicked") do 
+        @img_parameters = Actions.rotate_btn_action(@img_parameters)
+      end
+
+      # select button action
+      @button_set[:select_btn].signal_connect("clicked") do
+        @img_parameters = Actions.select_delete_btn_action(@window, @img_parameters, @button_set, "select")
+        
+      end
+
+      # delete button action
+      @button_set[:delete_btn].signal_connect("clicked") do
+        @img_parameters = Actions.select_delete_btn_action(@window, @img_parameters, @button_set, "delete")
+      end
+
+      @quit.signal_connect("activate") {Gtk.main_quit}
+
+       # pack the boxes
+      @box_set = Actions.pack_boxes(@window, @img_parameters[:img_current], @box_set, @button_set)
+
+      @window.show_all
+      Gtk.main
+    end
+  end
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: wuffl
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- BluePeony
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-05-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gtk3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fileutils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastimage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: stringio
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "# Wuffl\n<strong> 1. Introduction </strong>  \nWuffl is a simple image
+  viewer which can move pictures either to a „Selected“ folder or to a „Deleted“ folder.
+  \"Selected\" and \"Deleted\" folders are located in the same folder as the chosen
+  picture. Wuffl is available for Linux Ubuntu >=14.04, Mac and Windows.  \n\nImagine
+  you review you vacation photographs and you need to select which pictures to show
+  to your friends at the next party or you work your way through a bunch of old pictures
+  and you need to select a view of them for a anniversary celebration. Wuffl allows
+  you to move the picture to an extra folder (\"Selected\" folder) or to a \"Deleted\"
+  folder while viewing it. \n<p>\nSource for the icons of the buttons: http://icons.mysitemyway.com
+  \ \n</p>\n<strong> 2. Installation </strong>  \nTo use the Wuffl image viewer you
+  require:\n<ul>\n  <li> <a href=\"https://www.ruby-lang.org/en/downloads/\"><code>ruby</code></a>
+  (v2.4)\n</ul>\nas well as the following Ruby gems:  \n<ul>\n  <li><code>fastimage</code>\n
+  \ <li><code>fileutils</code>\n  <li><code>gtk3</code>\n  <li><code>stringio</code></li>\n</ul>
+  \ \n\nGet the Wullf image viewer by typing ```gem install wuffl``` in your command
+  line.\n\n<strong>3. Usage</strong>\nUsing your terminal or cmd start Wuffl by typing
+  \ \n<code> wuffl</code>\n\nAfter starting Wuffl you'll see a start screen with a
+  line of buttons at the bottom.  \nTo select an image go to the top left corner,
+  klick on <code>File</code> → <code>Open file</code> and browse to the location of
+  you images. Then select an image and click <code>open</code> or just doubleclick
+  on the selected image. \n\nThe buttons from left to right mean: <code>show previous
+  image</code>, <code>rotate current image</code>, <code>move the current image to
+  the folder 'Selected'</code>, <code>show next image</code>, <code>move the current
+  image to the folder 'Deleted'</code>.\n\n<strong>4. Remarks</strong>  \nIf you have
+  any remarks, bugs, questions etc. please tell me, I'd be happy to help. \n"
+email: blue.peony2314@gmail.com
+executables:
+- wuffl
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README
+- bin/wuffl
+- lib/wuffl/actions.rb
+- lib/wuffl/basic_elements.rb
+- lib/wuffl/image_actions.rb
+- lib/wuffl/wuffl_interface.rb
+homepage: https://github.com/BluePeony/wuffl
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.8
+signing_key:
+specification_version: 4
+summary: image viewer with options to put an image either to the folder 'Selected'
+  or the folder 'Deleted' to preselect them for further use
+test_files: []