Go to file
TuDatTr a54a02a5fb Added search query in output
Signed-off-by: TuDatTr <tuan-dat.tran@tudattr.dev>
2023-07-29 16:06:36 +02:00
src Added search query in output 2023-07-29 16:06:36 +02:00
.gitignore Initial commit 2023-06-10 21:53:14 +02:00
.gitlab-ci.yml Update .gitlab-ci.yml file 2023-06-10 19:58:21 +00:00
Cargo.lock Initial commit 2023-06-10 21:53:14 +02:00
Cargo.toml Added search query in output 2023-07-29 16:06:36 +02:00
LICENSE Add LICENSE 2023-06-10 20:08:14 +00:00
README.org Updated README.org 2023-06-10 22:12:18 +02:00



gsearch is a command-line tool based on gscite that allows you to quickly search for citations. It provides a convenient way to retrieve references based on a search term and display them in BibTeX format.


To use gsearch, you need to have Rust and Cargo installed on your system. If you don't have them installed, you can follow the official Rust installation guide at https://www.rust-lang.org/tools/install">https://www.rust-lang.org/tools/install.

Once you have Rust and Cargo set up, you can clone the gsearch repository from GitHub:

git clone https://github.com/your_username/gsearch.git

Change to the project directory:

cd gsearch

Build the project using Cargo:

cargo build --release

After a successful build, you can find the gsearch binary in the target/release directory.


To search for citations using gsearch, you need to provide a search term as a command-line argument. Here's an example:

$ ./gsearch --search_term "machine learning"

$ @book{zhou2021machine,
  title={Machine learning},
  author={Zhou, Zhi-Hua},
  publisher={Springer Nature}


The above command will search for references related to "machine learning" and display the first reference in BibTeX format.

Command-Line Arguments

gsearch supports the following command-line arguments:

  • --search_term or -s: The search term to be used for retrieving references. It is a required argument.


gsearch depends on the following libraries:

  • gscite: A Rust library for retrieving citations from Google Scholar.
  • futures_util: A collection of utility functions and combinators for working with asynchronous Rust.
  • clap: A powerful command-line argument parsing library for Rust.


Contributions to gsearch are welcome! If you find a bug or want to suggest an enhancement, you can open an issue on the GitLab Repository. If you would like to contribute code, feel free to submit a pull request.

When contributing to gsearch, please follow the existing code style and conventions. Make sure to write clear commit messages and add appropriate tests for your changes.


This project is licensed under the MIT License. See the LICENSE file for more information.


gsearch is a personal project created for educational and personal use only. It is not affiliated with or endorsed by Google Scholar. Use it responsibly and at your own risk.