brozzler - distributed browser-based web crawler
Find a file
Noah Levitt 85d87a5e42 Merge remote-tracking branch 'umbra/master'
* umbra/master:
  refactor umbraAboveBelowOrOnScreen into umbraBehavior object
  fixes for psu24 behavior
  More changes.
  Remove changes for https://webarchive.jira.com/browse/ARI-4518:
  Add fix for https://webarchive.jira.com/browse/ARI-4518
  More changes
  More changes for handling psu24 site
  Pulled in changes from https://github.com/nlevitt/umbra/tree/aitfive-451-alt
  simpler implementation for https://github.com/internetarchive/umbra/pull/42/files
  Adds routing_key to queue Queue creation
2015-11-03 15:31:38 -08:00
bin missed one more use of brozzler.version 2015-09-24 00:44:35 +00:00
brozzler Merge remote-tracking branch 'umbra/master' 2015-11-03 15:31:38 -08:00
docker websockify startup script 2015-11-03 20:15:41 +00:00
webconsole tweaking workers page 2015-10-29 01:01:28 +00:00
.gitignore update readme, s/umbra/brozzler/ in most places, delete non-brozzler stuff 2015-07-13 17:09:39 -07:00
.gitmodules switch noVNC git url to https 2015-10-29 21:36:43 +00:00
brozzler.svg symlink to root 2015-10-08 00:37:39 +00:00
cluster-control.sh proof of concept presenting workers in web console with novnc 2015-10-27 19:01:21 +00:00
license.txt apache license 2014-09-02 16:10:00 -07:00
README.rst logo 2015-10-07 17:53:16 -07:00
setup.py giving up on using git revision in version number :( latest issue is when installing a package that calls git to compute a version number, but cwd is some other git project, you get the wrong thing 2015-09-24 00:17:33 +00:00

.. |logo| image:: https://cdn.rawgit.com/nlevitt/brozzler/d1158ab2242815b28fe7bb066042b5b5982e4627/webconsole/static/brozzler.svg
   :width: 7%

brozzler |logo|
===============

"browser" \| "crawler" = "brozzler"

Brozzler is a distributed web crawler (爬虫) that uses a real browser
(chrome or chromium) to fetch pages and embedded urls and to extract
links. It also uses `youtube-dl <https://github.com/rg3/youtube-dl>`__
to enhance media capture capabilities.

It is forked from https://github.com/internetarchive/umbra.

Brozzler is designed to work in conjunction with
`warcprox <https://github.com/internetarchive/warcprox>`__ for web
archiving.

Installation
------------

XXX These instructions don't work at the moment. Brozzler requires some
customized packages not easily installable in the outside world. I intend to
remedy the situation soon.

::

    # set up virtualenv if desired
    pip install git+https://github.com/nlevitt/brozzler.git

Brozzler also requires a rethinkdb deployment.

Fonts for good screenshots
--------------------------

On ubuntu 14.04 trusty I installed these packages:

xfonts-base ttf-mscorefonts-installer fonts-arphic-bkai00mp
fonts-arphic-bsmi00lp fonts-arphic-gbsn00lp fonts-arphic-gkai00mp
fonts-arphic-ukai fonts-farsiweb fonts-nafees fonts-sil-abyssinica
fonts-sil-ezra fonts-sil-padauk fonts-unfonts-extra fonts-unfonts-core
ttf-indic-fonts fonts-thai-tlwg fonts-lklug-sinhala

Haven't looked much at the resulting screenshots yet though.

License
-------

Copyright 2015 Internet Archive

Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this software except in compliance with the License. You may
obtain a copy of the License at

::

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.