Metadata-Version: 2.1
Name: url2bib
Version: 0.2.1
Summary: Given a url returns a bibtex, uses publication if available
Home-page: https://github.com/notpaulmartin/url2bib
Author: Paul Martin
Author-email: p@ulmartin.com
License: GNU General Public License v3 (GPLv3)
Keywords: bibtex,science,scientific-journals,crossref,doi
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Topic :: Text Processing :: Markup :: LaTeX
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: bibtexparser
Requires-Dist: urllib3

# URL to BibTeX Converter (url2bib)

`url2bib` is a commandline tool for converting URLs of papers into into BibTeX citations. It tries to use the publication information rather than the arXiv url.

![screenshot.png](screenshot.png)

## Installation
```bash
pip install url2bib
```

## Usage 
```bash
url2bib https://arxiv.org/abs/2006.11477
```

## Features
- Extracts DOIs from URLs and retrieves BibTeX citations for those DOIs.
- Searches for publications of the paper.
- Generates a BibTeX entry with a unified ID in the format `{firstAuthorSurname}_{year}_{titleFirstWord}`.

## Contributing
Contributions to this project are welcome. If you have any suggestions or want to report issues, please open an issue or submit a pull request.

## License
This project is under the [GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0) license.

## Acknowledgments
This script uses the `bibtexparser` library for parsing and generating BibTeX entries.
It also relies on external data sources such as doi.org and dblp.org to fetch BibTeX entries.

## Disclaimer
This script is provided as-is, and the accuracy of the generated BibTeX entries depends on the availability and quality of external data sources. Always double-check and edit citations as needed for your research papers and publications.

Happy citing with `url2bib`!
