Skip to main content

Asynchronous python lib for

Project description


Asynchronous python library for to search and download books.

PyPI version Build Python Package

Bookdlbot Async telegram bot utilizing this library

Installing libgenesis

using the command line

pip install libgenesis

Importing libgenesis

from libgenesis import Libgen

Creating libgenesis object

lg = Libgen()


lg = Libgen(sort= 'year', sort_mode= 'ASC', result_limit= '50')

When creating an instance of LibGen, you can set 3 option.

  • sort: You can use this to choose a sorting method from allowed fields ( 'id', 'author', 'title', 'publisher', 'year', 'pages', 'language', 'size', 'extension'). Defaults to 'def'.
  • sort_mode: Pick the order of the sort ascending or decending ('ASC', 'DESC'). Defaults to 'DESC'.
  • result_limit: Limit the number of results based on the allowed limit (25, 50, 100). Defaults to 25.

Searching for a book

async def search():
    q = 'japan history'
    result = await
    for item in result:
        print('id = ' + item)
        print('title = ' + result[item]['title'])
        print('md5 = ' + result[item]['md5'])

The returned data looks like this: (The dict key is the Libgen id of the book)

        'title': 'The Japanese Experience: A Short History of Japan (History of Civilisation)',
        'volumeinfo': '',
        'series': '',
        'periodical': '',
        'author': 'W. G. Beasley',
        'year': '1999',
        'edition': '',
        'publisher': 'University of California Press',
        'city': '',
        'pages': '331',
        'language': 'English',
        'topic': '',
        'library': '',
        'issue': '0',
        'identifier': '0520220501, 9780520220508',
        'issn': '',
        'asin': '',
        'udc': '',
        'lbc': '',
        'ddc': '',
        'lcc': '',
        'doi': '',
        'googlebookid': '',
        'openlibraryid': '',
        'commentary': '',
        'dpi': '0',
        'color': '',
        'cleaned': '',
        'orientation': '',
        'paginated': '',
        'scanned': '',
        'bookmarked': '',
        'searchable': '1',
        'filesize': '29750320',
        'extension': 'pdf',
        'md5': 'a382109f7fdde3be5b2cb4f82d97443b',
        'generic': '',
        'visible': '',
        'local': '0',
        'timeadded': '2013-02-15 18:40:21',
        'timelastmodified': '2019-12-21 21:23:21',
        'coverurl': '',
        'identifierwodash': '0520220501,9780520220508',
        'tags': '',
        'pagesinfile': '331',
        'descr': '',
        'toc': '',
        'sha1': 'ZZYRRG56BOX3XAQ5D2IWAV2FUUC35ELG',
        'sha256': '3B40D6524409A18573900B729AB1BFB872E26CF111A4845F375A84BD0CB12460',
        'crc32': '3DB84D01',
        'edonkey': 'A63EEBB71C46DAE130725C07F2CDC67C',
        'aich': '733CLKTMCYOGD4W5PIG2GMA7CMLAFN2V',
        'btih': '84195af51fa738cb232297dd1376df6d8b8313be',
                'main': '',
                '': '',
                'z-library': '',
                '': '',
                'bookfi': '',
                'torrent': '',
                'torrent_1k': '',
                'gnutella': 'magnet:?xt=urn:sha1:ZZYRRG56BOX3XAQ5D2IWAV2FUUC35ELG&xl=29750320&dn=a382109f7fdde3be5b2cb4f82d97443b.pdf',
                'ed2k': 'ed2k://|file|A382109F7FDDE3BE5B2CB4F82D97443B.pdf|29750320|A63EEBB71C46DAE130725C07F2CDC67C|h=733CLKTMCYOGD4W5PIG2GMA7CMLAFN2V|/',
                'dc++': 'magnet:?xt=urn:tree:tiger:O4O5Z7UL2YAOUG57PINCLOAN63HVZPCSDYACT6Q&xl=29750320&dn=a382109f7fdde3be5b2cb4f82d97443b.pdf'

Note that the above information except for mirrors is fecthed as is from Libgen and it is up to the uploader of the books to include the metadata of the books.

Downloading a book

Downloading is only supported for the top 3 mirrors in the returned result ('main', '', 'z-library'). Pass one of the 3 links to the download method of the Libgen object. Optionaly a destination Path can be passed with the url using dest_folder argument. The output of the download method is a Path to the downloaded file.

async def download():
    q = 'japan history'
    result = await
    download_location = []
    path = Path('Downloads')
    for item in result:
        file_path = await[item]['mirrors']['main'],

async def progress(current, total, title):
    print('Downloading ', current, ' of ', total, ' ', title)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for libgenesis, version 0.1.8
Filename, size File type Python version Upload date Hashes
Filename, size libgenesis-0.1.8.tar.gz (12.5 kB) File type Source Python version None Upload date Hashes View
Filename, size libgenesis-0.1.8-py3-none-any.whl (11.9 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page