bettercap 1.4.2 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b2645aedfa3e74db2c01d8856b6c0149302317d5
-  data.tar.gz: 3e891382aec5781ff109d8e2e7705c48bc6cb3a7
+  metadata.gz: 004df8ac9f02a6075dffa69038fb4b8fd02b8e8b
+  data.tar.gz: 720d7f1c5bcc08ad97eb917291d9a8c8463cc892
 SHA512:
-  metadata.gz: a704b2a1156afa0a087a48d64041d3197f86664f778172acdf299fc34da6c6b602091961d86e484ca576f5c06408f3a91ec9610d324800285eb85747a1235d21
-  data.tar.gz: 33f2ed1ea9e4e643d196269f7015f4d47be69e175859355ca797bba1597d2bd8763cbe6bb011f6687a3725243d1f448a1e34bcc2318a42da410df8f4db4693bf
+  metadata.gz: c9a2e1722001bef5dbe99bc80e7c87b1ebfb3f2d93e85de449d272525332f04e098ad92d530b1b2e263da6e32a095c5044bb51bf543b6465e494da5b7dd249cd
+  data.tar.gz: eb475421115056754c756550a5379970532fc2b018a321a50bd1a3fdec16929f7cef71393ea37c722df4574ca68eec4f1a62cfc77a369b13ff6395c6bf7f9891

data/lib/bettercap.rb

@@ -28,9 +28,11 @@ Object.send :remove_const, :Config rescue nil
 Config = RbConfig
 
 def bettercap_autoload( path = '' )
-  dir = File.dirname(__FILE__) + "/bettercap/#{path}"
-  deps = []
-  files = []
+  dir    = File.dirname(__FILE__) + "/bettercap/#{path}"
+  deps   = []
+  files  = []
+  monkey = []
+
   Dir[dir+"**/*.rb"].each do |filename|
     filename = filename.gsub( dir, '' ).gsub('.rb', '')
     filename = "bettercap/#{path}#{filename}"
@@ -38,13 +40,15 @@ def bettercap_autoload( path = '' )
     unless filename =~ /.+\/inject[a-z]+$/i
       if filename.end_with?('/base')
         deps << filename
+      elsif filename.include?('monkey')
+        monkey << filename
       else
         files << filename
       end
     end
   end
 
-  ( deps + files ).each do |file|
+  ( deps + files + monkey ).each do |file|
     require file
   end
 end

data/lib/bettercap/monkey/celluloid/io/udp_socket.rb

@@ -0,0 +1,28 @@
+# encoding: UTF-8
+=begin
+
+BETTERCAP
+
+Author : Simone 'evilsocket' Margaritelli
+Email  : evilsocket@gmail.com
+Blog   : http://www.evilsocket.net/
+
+This project is released under the GPL 3 license.
+
+=end
+
+# Monkey patching fix for https://github.com/evilsocket/bettercap/issues/154
+module Celluloid
+  module IO
+    class UDPSocket
+      def initialize(address_family = ::Socket::AF_INET)
+        begin
+          @socket = ::UDPSocket.new(address_family)
+        rescue Errno::EMFILE
+          sleep 0.5
+          retry
+        end
+      end
+    end
+  end
+end

data/lib/bettercap/network/target.rb

@@ -38,6 +38,7 @@ class Target
   NBNS_REQUEST = "\x82\x28\x0\x0\x0\x1\x0\x0\x0\x0\x0\x0\x20\x43\x4B\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x41\x0\x0\x21\x0\x1"
 
   @@prefixes = nil
+  @@lock = Mutex.new
 
   # Create a +Target+ object given its +ip+ and (optional) +mac+ address.
   # The +ip+ argument could also be a MAC address itself, in this case the
@@ -143,17 +144,19 @@ private
 
   # Lookup the given +mac+ address in order to find its vendor.
   def self.lookup_vendor( mac )
-    if @@prefixes == nil
-      Logger.debug 'Preloading hardware vendor prefixes ...'
-
-      @@prefixes = {}
-      filename = File.dirname(__FILE__) + '/hw-prefixes'
-      File.open( filename ).each do |line|
-        if line =~ /^([A-F0-9]{6})\s(.+)$/
-          @@prefixes[$1] = $2
+    @@lock.synchronize {
+      if @@prefixes.nil?
+        Logger.debug 'Preloading hardware vendor prefixes ...'
+
+        @@prefixes = {}
+        filename = File.dirname(__FILE__) + '/hw-prefixes'
+        File.open( filename ).each do |line|
+          if line =~ /^([A-F0-9]{6})\s(.+)$/
+            @@prefixes[$1] = $2
+          end
         end
       end
-    end
+    }
 
     @@prefixes[ mac.split(':')[0,3].join('').upcase ]
   end

data/lib/bettercap/options.rb

@@ -79,6 +79,8 @@ class Options
   attr_accessor :custom_https_proxy
   # Custom HTTPS transparent proxy port.
   attr_accessor :custom_https_proxy_port
+  # Custom list of redirections.
+  attr_accessor :custom_redirections
   # If true, BetterCap::Network::Servers::HTTPD will be enabled.
   attr_accessor :httpd
   # The port to bind HTTP server to.
@@ -145,6 +147,8 @@ class Options
     @custom_https_proxy = nil
     @custom_https_proxy_port = 8083
 
+    @custom_redirections = []
+
     @sslstrip = true
 
     @httpd = false
@@ -312,6 +316,10 @@ class Options
         ctx.options.custom_https_proxy_port = v.to_i
       end
 
+      opts.on( '--custom-redirection RULE', 'Apply a custom port redirection, the format of the rule is "PROTOCOL ORIGINAL_PORT NEW_PORT". For instance "TCP 21 2100" will redirect all TCP traffic going to port 21, to port 2100.' ) do |v|
+        ctx.options.parse_redirection!( v )
+      end
+
       opts.on( '--httpd', 'Enable HTTP server, default to false.' ) do
         ctx.options.httpd = true
       end
@@ -448,6 +456,19 @@ class Options
     end
   end
 
+  # Parse a custom redirection rule.
+  def parse_redirection!(rule)
+    if rule =~ /^((TCP)|(UDP))\s+(\d+)\s+(\d+)$/i
+      @custom_redirections << {
+        :proto => $1.upcase,
+        :from  => $4.to_i,
+        :to    => $5.to_i
+      }
+    else
+      raise BetterCap::Error, 'Invalid custom redirection rule specified.'
+    end
+  end
+
   # Parse a comma separated list of ports and return an array containing only
   # valid ports, raise BetterCap::Error if that array is empty.
   def parse_ports(value)
@@ -511,7 +532,7 @@ class Options
   def get_redirections ifconfig
     redirections = []
 
-    if @dnsd or @proxy
+    if @dnsd or ( @proxy and @sslstrip )
       redirections << redir( ifconfig[:ip_saddr], 53, @dnsd_port )
       redirections << redir( ifconfig[:ip_saddr], 53, @dnsd_port, 'UDP' )
     end
@@ -540,6 +561,10 @@ class Options
       end
     end
 
+    @custom_redirections.each do |r|
+      redirections << redir( ifconfig[:ip_saddr], r[:from], r[:to], r[:proto] )
+    end
+
     redirections
   end
 
@@ -555,7 +580,7 @@ class Options
       'https-proxy' => ( proxy_https ? on : off ),
       'sslstrip'    => ( ( proxy and sslstrip ) ? on : off ),
       'http-server' => ( httpd ? on : off ),
-      'dns-server'  => ( ( sslstrip or dnsd ) ? on : off )
+      'dns-server'  => ( ( ( proxy and sslstrip ) or dnsd ) ? on : off )
     }
 
     msg = "Starting [ "

data/lib/bettercap/proxy/proxy.rb

@@ -22,18 +22,19 @@ class Proxy
   # use the specified +processor+ routine for each request.
   # If +is_https+ is true a HTTPS proxy will be created, otherwise a HTTP one.
   def initialize( address, port, is_https, processor )
-    @socket      = nil
-    @address     = address
-    @port        = port
-    @is_https    = is_https
-    @type        = is_https ? 'HTTPS' : 'HTTP'
-    @sslserver   = nil
-    @sslcontext  = nil
-    @server      = nil
-    @main_thread = nil
-    @running     = false
-    @streamer    = Streamer.new processor
-    @local_ips   = []
+    @socket        = nil
+    @address       = address
+    @port          = port
+    @is_https      = is_https
+    @type          = is_https ? 'HTTPS' : 'HTTP'
+    @upstream_port = is_https ? 443 : 80
+    @sslserver     = nil
+    @sslcontext    = nil
+    @server        = nil
+    @main_thread   = nil
+    @running       = false
+    @streamer      = Streamer.new processor
+    @local_ips     = []
 
     begin
       @local_ips = Socket.ip_address_list.collect { |x| x.ip_address }
@@ -49,7 +50,7 @@ class Proxy
       begin
        client_worker client
       rescue Exception => e
-        Logger.warn "Client worker errort: #{e.message}"
+        Logger.warn "Client worker error: #{e.message}"
         Logger.exception e
       end
     end
@@ -125,7 +126,7 @@ class Proxy
 
   # Handle a new +client+.
   def client_worker( client )
-    request = Request.new @is_https ? 443 : 80
+    request = Request.new @upstream_port
 
     begin
       Logger.debug 'Reading request ...'

data/lib/bettercap/proxy/response.rb

@@ -15,6 +15,12 @@ module BetterCap
 module Proxy
 # HTTP response parser.
 class Response
+  # HTTP protocol version
+  attr_accessor :version
+  # Response status code.
+  attr_accessor :code
+  # Response status message
+  attr_accessor :status
   # Response content type.
   attr_reader :content_type
   # Response charset, default to UTF-8.
@@ -25,10 +31,6 @@ class Response
   attr_reader :chunked
   # A list of response headers.
   attr_accessor :headers
-  # Response status code.
-  attr_accessor :code
-  # True if the parser finished to parse the headers, otherwise false.
-  attr_reader :headers_done
   # Response body.
   attr_accessor :body
 
@@ -67,12 +69,14 @@ class Response
 
   # Initialize this response object state.
   def initialize
+    @version = '1.1'
+    @code = 200
+    @status = 'OK'
     @content_type = nil
     @charset = 'UTF-8'
     @content_length = nil
-    @body = ''
-    @code = nil
-    @headers = []
+    @body = nil
+    @headers = {}
     @headers_done = false
     @chunked = false
   end
@@ -100,37 +104,53 @@ class Response
   def <<(line)
     # we already parsed the heders, collect response body
     if @headers_done
+      @body = '' if @body.nil?
       @body << line.force_encoding( @charset )
     else
-      Logger.debug "  RESPONSE LINE: '#{line.chomp}'"
-
-      # parse the response status
-      if @code.nil? and line =~ /^HTTP\/[\d\.]+\s+(.+)/
-        @code = $1.chomp
-
-      # parse the content type
-      elsif line =~ /^Content-Type:\s*([^;]+).*/i
-        @content_type = $1.chomp
-        if line =~ /^.+;\s*charset=(.+)/i
-          @charset = $1.chomp
+      chomped = line.chomp
+      Logger.debug "  RESPONSE LINE: '#{chomped}'"
+
+      # is this the first line 'HTTP/<VERSION> <CODE> <STATUS>' ?
+      if chomped =~ /^HTTP\/([\d\.]+)\s+(\d+)\s+(.+)$/
+        @version = $1
+        @code    = $2.to_i
+        @status  = $3
+
+      # collect and fix headers
+      elsif chomped =~ /^([^:\s]+)\s*:\s*(.+)$/i
+        name = $1
+        value = $2
+
+        if name == 'Content-Type'
+          @content_type = value
+          if value =~ /^(.+);\s*charset=(.+)/i
+            @content_type = $1
+            @charset = $2.chomp
+          end
+        elsif name == 'Content-Length'
+          @content_length = value.to_i
+        # check if we have a chunked encoding
+        elsif name == 'Transfer-Encoding' and value == 'chunked'
+          @chunked = true
+          name     = nil
+          value    = nil
         end
 
-      # parse content length
-      elsif line =~ /^Content-Length:\s+(\d+)\s*$/i
-        @content_length = $1.to_i
-
-      # check if we have a chunked encoding
-      elsif line =~ /^Transfer-Encoding:\s*chunked.*$/i
-        @chunked = true
-        line = nil
-
+        unless name.nil? or value.nil?
+          if @headers.has_key?(name)
+            if @headers[name].is_a?(Array)
+              @headers[name] << value
+            else
+              @headers[name] = [ @headers[name], value ]
+            end
+          else
+            @headers[name] = value
+          end
+        end
       # last line, we're done with the headers
-      elsif line.chomp.empty?
+      elsif chomped.empty?
         @headers_done = true
-
       end
-
-      @headers << line.chomp unless line.nil?
     end
   end
 
@@ -141,62 +161,61 @@ class Response
 
   # Return the value of header with +name+ or an empty string.
   def [](name)
-    @headers.each do |header|
-      if header =~ /^#{name}:\s*(.+)$/i
-        return $1
-      end
-    end
-    ""
+    ( @headers.has_key?(name) ? @headers[name] : "" )
   end
 
   # If the header with +name+ is found, then a +value+ is assigned to it,
   # otherwise it's created.
   def []=(name, value)
-    found = false
-    @headers.each_with_index do |header,i|
-      if header =~ /^#{name}:\s*.+$/i
-        if value.nil?
-          @headers.delete(i)
-        else
-          @headers[i] = "#{name}: #{value}"
-        end
-
-        found = true
-        break
+    if @headers.has_key?(name)
+      if value.nil?
+        @headers.delete(name)
+      else
+        @headers[name] = value
       end
-    end
-
-    unless found or value.nil?
-      @headers << "#{name}: #{value}"
+    elsif !value.nil?
+      @headers[name] = value
     end
   end
 
-  def each_header(name)
-    @headers.each_with_index do |header,i|
-      if header =~ /^#{name}:\s*(.+)$/i
-        yield( $1, i )
+  # Search for header +name+ and apply a gsub substitution:
+  #   value.gsub( +search+, +replace+ )
+  def patch_header!( name, search, replace )
+    value = self[name]
+    unless value.empty?
+      patched = []
+      if value.is_a?(Array)
+        value.each do |v|
+          patched << v.gsub( search, replace )
+        end
+      else
+        patched << value.gsub( search, replace )
       end
+
+      self[name] = patched
     end
   end
 
   # Return a string representation of this response object, patching the
   # Content-Length header if the #body was modified.
   def to_s
-    if textual?
-      @headers.map! do |header|
-        # update content length in case the body was
-        # modified
-        if header =~ /Content-Length:\s*(\d+)/i
-          Logger.debug "Updating response content length from #{$1} to #{@body.bytesize}"
-
-          "Content-Length: #{@body.bytesize}"
-        else
-          header
+    # update content length in case the body was modified.
+    if @headers.has_key?('Content-Length')
+      @headers['Content-Length'] = @body.nil?? 0 : @body.bytesize
+    end
+
+    s = "HTTP/#{@version} #{@code} #{@status}\n"
+    @headers.each do |name,value|
+      if value.is_a?(Array)
+        value.each do |v|
+          s << "#{name}: #{v}\n"
         end
+      else
+        s << "#{name}: #{value}\n"
       end
     end
-
-    @headers.join("\n") + "\n" + ( @body || "\n" )
+    s << "\n" + ( @body.nil?? "\n" : @body )
+    s
   end
 end
 

data/lib/bettercap/proxy/sslstrip/strip.rb

@@ -101,11 +101,12 @@ class Strip
   HTTPS_URL_RE  = /(https:\/\/[^"'\/]+)/i
 
   # Create an instance of this object.
-  def initialize
+  def initialize( ctx )
     @stripped = []
     @cookies  = CookieMonitor.new
     @favicon  = Response.from_file( File.dirname(__FILE__) + '/lock.ico', 'image/x-icon' )
-    @resolver = BetterCap::Network::Servers::DNSD.new
+    @resolver = BetterCap::Network::Servers::DNSD.new( nil, ctx.ifconfig[:ip_saddr], ctx.options.dnsd_port )
+
     @resolver.start
   end
 
@@ -162,22 +163,30 @@ class Strip
 
   private
 
+  # Headers to patch both in requests and responses.
+  HEADERS_TO_PATCH = {
+    :req => {
+      'Accept-Encoding'           => nil,
+      'If-None-Match'             => nil,
+      'If-Modified-Since'         => nil,
+      'Upgrade-Insecure-Requests' => nil,
+      'Pragma'                    => 'no-cache'
+    },
+
+    :res => {
+      'X-Frame-Options'           => nil,
+      'X-Content-Type-Options'    => nil,
+      'X-Xss-Protection'          => nil,
+      'Strict-Transport-Security' => nil,
+      'Content-Security-Policy'   => nil
+    }
+  }.freeze
+
   # Clean some headers from +r+.
   def process_headers!(r)
-    # clean request
-    if r.is_a?(BetterCap::Proxy::Request)
-      r['Accept-Encoding']           = nil
-      r['If-None-Match']             = nil
-      r['If-Modified-Since']         = nil
-      r['Upgrade-Insecure-Requests'] = nil
-      r['Pragma']                    = 'no-cache'
-    # clean response
-    else
-      r['X-Frame-Options']           = nil
-      r['X-Content-Type-Options']    = nil
-      r['X-Xss-Protection']          = nil
-      r['Strict-Transport-Security'] = nil
-      r['Content-Security-Policy']   = nil
+    what = r.is_a?(BetterCap::Proxy::Request) ? :req : :res
+    HEADERS_TO_PATCH[what].each do |key,value|
+      r[key] = value;
     end
   end
 
@@ -247,7 +256,6 @@ class Strip
       # no cookies set, just a normal http -> https redirect
       if response['Set-Cookie'].empty?
         Logger.info "[#{'SSLSTRIP'.green} #{request.client}] Found redirect to HTTPS '#{original}' -> '#{stripped}'."
-
         # The request will be retried on port 443 if MAX_REDIRECTS is not reached.
         request.port = 443
         # retry the request if possible
@@ -257,11 +265,9 @@ class Strip
         Logger.info "[#{'SSLSTRIP'.green} #{request.client}] Found redirect to HTTPS ( with cookies ) '#{original}' -> '#{stripped}'."
         # we know this session, do not kill it!
         @cookies.add!( request )
-        # remove the 'secure' descriptor from every cookie
-        response.each_header('Set-Cookie') do |value,i|
-          response.headers[i] = "Set-Cookie: #{value.gsub( /secure/, '' )}"
-        end
-
+        # remove the 'secure' flag from every cookie.
+        # ref: https://www.owasp.org/index.php/SecureFlag
+        response.patch_header!( 'Set-Cookie', /secure/, '' )
         # do not retry request
         return false
       end
@@ -276,6 +282,10 @@ class Strip
     begin
       response.body.scan( HTTPS_URL_RE ).uniq.each do |link|
         if link[0].include?('.')
+          # yeah, some idiots are using \ instead of / as a path -.-
+          if link[0].end_with?('\\')
+            link[0][-1] = '/'
+          end
           links << StrippedObject.process( link[0] )
         end
       end
@@ -296,9 +306,15 @@ class Strip
   private
 
   def add_stripped_object( o )
-    @stripped << o
-    # make sure we're able to resolve the stripped domain
-    @resolver.add_rule( o.stripped_hostname, IPSocket.getaddress( o.original_hostname ) )
+    begin
+      stripped_hostname = o.stripped_hostname
+      original_address  = IPSocket.getaddress( o.original_hostname )
+      @stripped << o
+      # make sure we're able to resolve the stripped domain
+      @resolver.add_rule( stripped_hostname, original_address )
+    rescue Exception => e
+      Logger.exception(e)
+    end
   end
 end
 

data/lib/bettercap/proxy/stream_logger.rb

@@ -27,6 +27,7 @@ class StreamLogger
   }
 
   @@services = nil
+  @@lock = Mutex.new
 
   # Search for the +addr+ IP address inside the list of collected targets and return
   # its compact string representation ( @see BetterCap::Target#to_s_compact ).
@@ -47,15 +48,17 @@ class StreamLogger
 
   # Given +proto+ and +port+ return the network service name if possible.
   def self.service( proto, port )
-    if @@services.nil?
-      @@services = { :tcp => {}, :udp => {} }
-      filename = File.dirname(__FILE__) + '/../network/services'
-      File.open( filename ).each do |line|
-        if line =~ /([^\s]+)\s+(\d+)\/([a-z]+).*/i
-          @@services[$3.to_sym][$2.to_i] = $1
+    @@lock.synchronize {
+      if @@services.nil?
+        @@services = { :tcp => {}, :udp => {} }
+        filename = File.dirname(__FILE__) + '/../network/services'
+        File.open( filename ).each do |line|
+          if line =~ /([^\s]+)\s+(\d+)\/([a-z]+).*/i
+            @@services[$3.to_sym][$2.to_i] = $1
+          end
         end
       end
-    end
+    }
 
     if @@services.has_key?(proto) and @@services[proto].has_key?(port)
       @@services[proto][port]
@@ -146,7 +149,7 @@ class StreamLogger
   def self.log_http( request, response )
     response_s = "( #{response.content_type} )"
     request_s  = request.to_url( request.post?? nil : @@MAX_REQ_SIZE )
-    code       = response.code[0]
+    code       = response.code.to_s[0]
 
     if @@CODE_COLORS.has_key? code
       response_s += " [#{response.code}]".send( @@CODE_COLORS[ code ] )

data/lib/bettercap/proxy/streamer.rb

@@ -20,7 +20,7 @@ class Streamer
   def initialize( processor )
     @processor = processor
     @ctx       = Context.get
-    @sslstrip  = SSLStrip::Strip.new if @ctx.options.sslstrip
+    @sslstrip  = SSLStrip::Strip.new( @ctx ) if @ctx.options.sslstrip
   end
 
   # Return true if the +request+ was stripped.

data/lib/bettercap/version.rb

@@ -12,7 +12,7 @@ This project is released under the GPL 3 license.
 =end
 module BetterCap
   # Current version of bettercap.
-  VERSION = '1.4.2'
+  VERSION = '1.4.3'
   # Program banner.
   BANNER = File.read( File.dirname(__FILE__) + '/banner' ).gsub( '#VERSION#', "v#{VERSION}")
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bettercap
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.4.3
 platform: ruby
 authors:
 - Simone Margaritelli
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-17 00:00:00.000000000 Z
+date: 2016-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize
@@ -115,7 +115,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CONTRIBUTING.md
 - LICENSE.md
 - README.md
 - bin/bettercap
@@ -134,6 +133,7 @@ files:
 - lib/bettercap/firewalls/redirection.rb
 - lib/bettercap/loader.rb
 - lib/bettercap/logger.rb
+- lib/bettercap/monkey/celluloid/io/udp_socket.rb
 - lib/bettercap/monkey/packetfu/utils.rb
 - lib/bettercap/network/arp_reader.rb
 - lib/bettercap/network/hw-prefixes

data/CONTRIBUTING.md

@@ -1,42 +0,0 @@
-# How To Contribute
-
-As any other open source projects, there're many ways you can contribute to bettercap depending on your skills as a developer or will to help as a user, but first 
-of all let me thank you for your help! <3
-
-### Submitting Issues
-
-If you find bugs or inconsistencies while using bettercap, you can create an **Issue** using the [GitHub Issue tracker](https://github.com/evilsocket/bettercap/issues), but before doing that please make sure that:
-
-* You are using a relatively new Ruby version ( >= 1.9 ) : `ruby -v`.
-* Your GEM environment is configured properly and updated : `sudo gem update`.    
-* You are using the latest version of bettercap : `bettercap --check-updates`.
-* The bug you're reporting is actually related to bettercap and not to one of the other GEMs.
-
-Once you've gone through this list, open an issue and please give us as much as informations as possible in order for us to fix the bug as soon as possible:
-
-* Your OS version.
-* Ruby version you're using.
-* Full output of the error ( exception backtrace, error message, etc ).
-* Your network configuration: `ifconfig -a`
-
-Also, you should attach to the issue a debug log that you can generate with:
-
-    [sudo|rvmsudo] bettercap [arguments you are using for testing] --debug --log=debug.log
-
-Wait for the error to happen then close bettercap and paste the **debug.log** file inside the issue.
-
-### Pull Requests
-
-If you know how to code in Ruby and have ideas to improve bettercap, you're very welcome to send us pull requests, we'll be happy to merge them whenever they comply to the following rules:
-
-* You have at least manually tested your code, ideally you've created actual tests for it.
-* Respect our coding standard, 2 spaces indentation and modular code.
-* There're no conflicts with the current dev branch.
-* Your commit messages are enough explanatory to us.
-
-There're plenty of things you can to do improve the software:
-
-* Implement a new proxy module and push it to the [dedicated repository](https://github.com/evilsocket/bettercap-proxy-modules).
-* Implement a new [Spoofer module](https://github.com/evilsocket/bettercap/blob/master/lib/bettercap/spoofers/arp.rb).
-* Implement a new [Sniffer credentials parser](https://github.com/evilsocket/bettercap/blob/master/lib/bettercap/sniffer/parsers/post.rb).
-* Fix, extend or improve the core.