Skip to main content

An open source reference management tool developed in PyQt5 and Python3.

Project description

MeiTing Trunk

An open source reference management tool developed in PyQt5 and Python3.

Features

Libraries

  • Create, manage and switch between multiple libraries.

Folders

  • Oragnize documents in a folder tree, with arbitrary level of folder nesting.
  • Add a document to multiple folders without taking up duplicate storage.

Import format

  • Import via bibtex files.
  • Import via RIS files.
  • Import PDF files (currently with limited meta data fetching capability).
  • Update meta data using DOI.

Export format

  • Export to bibtex.
  • Export to RIS.
  • Bulk export, per folder, or per document.

Searching and filtering

  • Filter document using authors, keywords, tags or publications.
  • Search meta data within folders or library.
  • Duplicate checking within folders or library.

Note taking

  • Jot down your thoughts while reading, in your referred editor. (currently with limited formating options).

Database

  • Meta data saved in sqlite format, transparent and easy to manipulate.
  • library saved in a portable manner, backup or share using your prefered online/offline tools.

Full text search (experimental)

  • Utilises Xapian engine to enable full text search inside attachment files (including PDFs, docs etc.).

PDF preview and reader

  • Use pdf.js as a build-in PDF reader.
  • Use poppler to generate PDF thumbnails.

Free and open source

  • Open to suggestions, bug reports and new ideas.

Screenshots

Main interface

Bulk export.

Duplicate checking results.

Merge duplicates.

Meta data searching.

Full text search.

Actions on documents.

Merge inconsistent journal names

Platforms and Dependencies

Currently only support Linux and MacOS.

Python dependencies

  • python3+
  • PyQt5>=5.12
  • PyQtWebEngine (this is no longer shipped with PyQt5 after 5.11)
  • sqlite3
  • pdfminer.six
  • PyPDF2
  • beautifulsoup4
  • bibtexparser
  • fuzzywuzzy
  • crossrefapi
  • RISparser
  • send2trash
  • python-levenshtein (optional)

Other dependencies

  • xapian-core, xapian-omega and the python bindings of xapian (all optional), required for full text searching. See https://xapian.org/docs/install.html for installation instructions. Also checkout the wiki page on how to enable snippets.

  • poppler (optional), used for generating PDF thumbnails.

Install

install using pip

pip install meitingtrunk

Then launch it in the terminal with

$ meitingtrunk

To upgrade:

pip install --upgrade meitingtrunk

Manual install

You can clone this repo

git clone https://github.com/Xunius/MeiTingTrunk

Check out the dependency list if any module is missing in your python environment.

Then launch it with

$ cd MeiTingTrunk
$ python -m MeiTingTrunk.main

Contribution

This software is still in its very early stage. Please consider helping by trying it out, sending issues, suggestions, ideas or contributing code.

Major features that are still lacking (I greatly appreciate any help with any of them):

  • Format citations into various citation styles, in a format suitable to paste into word editors.
  • Import from Zotero.
  • Other document types aside articles and books.
  • Packaging into a format suitable for a few mainstream Linux package management tools.
  • Of cource, any stability or performance improvements.

Licence

This file is distributed under the terms of the GPLv3 licence. See the LICENSE file for details. You may use, distribute and modify this code under the terms of the GPLv3 license.

Project details


Download files

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

Source Distribution

meitingtrunk-0.1a31.tar.gz (4.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meitingtrunk-0.1a31-py3-none-any.whl (5.2 MB view details)

Uploaded Python 3

File details

Details for the file meitingtrunk-0.1a31.tar.gz.

File metadata

  • Download URL: meitingtrunk-0.1a31.tar.gz
  • Upload date:
  • Size: 4.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

File hashes

Hashes for meitingtrunk-0.1a31.tar.gz
Algorithm Hash digest
SHA256 4e43572a2cc3d9f1b8bce779b67b114f27576d2c4cdb87f9353e07a5916b9e70
MD5 643bec6132168037c78a2a7dfa8c9781
BLAKE2b-256 837b2d00ec7a3dc7a58ee5cf896c8caf72c1582af972dfd3f00810ddfe4df56e

See more details on using hashes here.

File details

Details for the file meitingtrunk-0.1a31-py3-none-any.whl.

File metadata

  • Download URL: meitingtrunk-0.1a31-py3-none-any.whl
  • Upload date:
  • Size: 5.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

File hashes

Hashes for meitingtrunk-0.1a31-py3-none-any.whl
Algorithm Hash digest
SHA256 99c17e806ffcc4318db6cc800dba21601bc12013052b02015f32c464e91c7fcb
MD5 a443b1fd78a2db19071df375b2cc85d0
BLAKE2b-256 fd887f2fc34d36728a6c72f2a04d01240d3a01403f8941ab2f55c929998db34b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page