looqs/README.md

57 lines
2.3 KiB
Markdown
Raw Normal View History

2022-04-24 15:51:58 +02:00
# looqs - FTS for the Linux desktop with previews for search results
looqs creates a full text search index for your files. It allows you to look at previews where your
search terms have been found, as shown in the screenshots below.
2018-01-03 09:40:13 +01:00
2018-08-12 16:47:55 +02:00
## Screenshots
2022-04-14 16:54:46 +02:00
### List
![Screenshot looqs results](https://garage.quitesimple.org/assets/looqs/opearting_systems_looqs.png)
### Preview
![Screenshot looqs](https://garage.quitesimple.org/assets/looqs/orwell.png)
![Screenshot looqs search fstream](https://garage.quitesimple.org/assets/looqs/fstream_write.png)
## Current status
Last version: 2022-0X-XX, v0.1
Please see [Changelog](CHANGELOG.md) for a human readable list of changes.
2020-08-24 22:18:49 +02:00
2021-08-11 21:05:39 +02:00
## Goals and principles
* **Find & Preview**. Instead of merely telling you where your search phrase has been found, it should also render the corresponding portion/pages of the documents and highlight the searched words.
2022-04-24 15:51:58 +02:00
* **No daemons**. As some other desktop search projects are prone to have annoying daemons running that eat system resources away, this solution should make do without daemons where possible.
2021-08-11 21:05:39 +02:00
* **Easy setup**. Similiarly, there should be no need for heavy-weight databases. Instead, this solution tries to squeeze out the most from simple approaches. In particular, it relies on sqlite.
* **GUI & CLI**. Provide CLI interfaces and GUI interfaces
2021-08-11 21:05:39 +02:00
* **Sandboxing**. As reading and rendering lots of formats naturally opens the door for security bugs, those tasks are offloaded to small, sandboxed sub-processes to mitigate the effect of exploited vulnerabilities.
2020-08-24 22:52:52 +02:00
2022-04-14 16:54:46 +02:00
## Supported platforms
2022-04-24 15:51:58 +02:00
Linux (on amd64) is currently the main focus. Currently, I don't plan on supporting anything else and the sandboxing architecture does not make it likely. I suppose a version without sandboxing might be conceivable for other platforms, but I have no plans or resources to actively target anything but Linux at this point.
### Licence
GPLv3.
### Contributing
Fow now, github issues and pull-requests are preferred, but you can also just email
your patches or issues to : looqs at quitesimple.org
2022-04-14 16:54:46 +02:00
## Build
2022-04-24 15:51:58 +02:00
### Ubuntu 21.10/22.04
```
2022-04-24 15:51:58 +02:00
git submodule init
git submodule update
sudo apt install build-essential qtbase5-dev libpoppler-qt5-dev libuchardet-dev libquazip5-dev
qmake
make
```
2022-04-24 15:51:58 +02:00
## Documentation
2022-04-24 15:51:58 +02:00
Please see [Usage.md](USAGE.md) for the user manual.
2020-08-24 22:18:49 +02:00
## Packages
Coming soon™