ark-builders / ark-shelf Goto Github PK

ARK Shelf is where you put your bookmarks during your web surfing. Android version.

License: MIT License

Kotlin 100.00%

android bookmark-manager bookmarks bookmarks-manager internet kotlin web links offline offline-capable offline-first organizer save

ark-shelf's Introduction

ARK Shelf: Reliable Bookmark Keeper by ARK Builders

Don't lose important links in endless chats and browser tabs - whether it's vital information, intriguing content, or something you plan to view later. ARK Shelf is perfect for work and study, keeping all your links in one convenient place, just like a bookshelf.

Easy and Flexible Keeper

Share a link from any app - be it a browser or a messenger - and it will be saved to your phone's memory. This is especially convenient if you use different browsers on the same device. Open a previously saved link in any browser or share it with friends, without the need to wait for it to load.

Our app is light, fast, and has an ultra-simple user interface.

Sync and Backup

Easily transfer your links to a second device, like a tablet, using third-party apps such as Syncthing or Google Drive. The app stores your links as plain files in a folder of your choice.

Enhanced Privacy

Your data stays only on your devices. The only time the app goes into internet is when it grabs previews. We respect your privacy and do not collect any personal data.

Completely autonomous

Even without an internet connection, you can save a link or transfer data to a computer via a cable.

And also, coming soon:

Sorting links using tags for even better organization. Both manual and automatic, based on link domains.
Desktop version with built-in synchronization will allow you to continue working on another device without data loss.
Downloading pages for offline viewing of important pages.

ARK Shelf — a simple, yet powerful tool for saving and organizing your links. Download today and discover how we can simplify your life on the Internet.

ark-shelf's People

Contributors

Stargazers

Watchers

Forkers

hhio618

ark-shelf's Issues

Handle absence of the folder during startup

Start the app and choose a folder to store links.
Close the app.
Delete the folder from disk.
Start the app again.

The app crashes and can't start.

Labeling links with tags

Would be nice to be able to label new link (when we handle Share intent) with some tags.

After adding a link using Share intent the app must close

Suppose, a user is sharing some link from web browser in ARK Shelf.

Right now, the link is previewed to the user, then the user clicks [save] button and empty input box is presented to her. The user must be brought back to web browser, so she could continue surfing.

Also, after a while, app instances pile up in background. Maybe we should limit amount of instances to just 1.

List of stored links

When the app is launched normally (not using Share intent) it should display all links stored in the configured folder.
The links should be organized as list, where each row has:

Preview and title of the link.
Shorted versions of its description and URL.
Buttons:
a. [open] which opens the link in a browser.
b. [share] which sends the link to destination of choice.
c. [copy] which copies the link into copy/paste buffer.

If a row is clicked, the description should unfold and preview should become larger.

Preview/thumbnail idea can be used, the same as in ARK Navigator.

Existing bookmarks don't load without restart

Open the app for the very first time.
Input link, try to save.
Select existing folder.
The link is saved.
Bookmarks from the folder are not loaded.

Split APK by each target in order to reduce size

The APK was ~ 6MB before we introduced arklib into the project:
https://github.com/ARK-Builders/ARK-Shelf/actions/runs/2711988751

Now it is 50MB:
https://github.com/ARK-Builders/ARK-Shelf/actions/runs/2905621288

I think we can do the same split build as in ARK Navigator.

"Link to Web" resource kind

It should be possible to work with URLs using the app.
This allows a user to use our app as bookmarks keeper.

Sharing a link from external apps must result in saving the link into one of user's folders.
Links should be represented as separate entities in resources grid and gallery view.
Opening any link must be possible with Firefox or Chrome.
Opening specific links should be possible with specialized apps (e.g. YouTube, MeetUp).

Open questions:

Storage format. The easiest way is to save every URL into HTML file.
Batching links into one file-database per root/favorite might be more efficient, especially for indexing.
Reading of Firefox/Chrome export files (XML).
Should we convert those files into our format or just adapt to them?

Automatically extract Domain tags

Implementing a tag extraction mechanism based on the domain of a link could significantly improve user experience. For instance, if a user saves links like https://youtube.com/watch?v=123 or https://youtube.com/watch?v=qwe, the system could automatically label the links using youtube tag.

We could initially implement this feature within the application, transitioning it into the library later.

Similar issues in Navigator:

Delete a link

User must be able to remove any link from the list and the corresponding file from the folder.

Basic links saving

ARK Shelf must be able to save URLs into a folder (should be able to set default folder in settings).

The format is flexible. It can be JSON containing URL, description and maybe other metadata.

The easiest way to enable previews for stored links is to download image using OGP and store it into ZIP archive together with the JSON. Later, when the library will be ready, the app will be able to generate previews directly into necessary folder. Right now, it is supposed to extract the image from ZIP during indexing and saving it as preview (this is sub-optimal due to duplication, but fine for Proof-of-Concept).

ARK Shelf must be able to add link manually by pressing some button or receive sharing intent with URL. Dialogue should be displayed with default description and folder which are possible to be modified by user. Folder picker might be taken from ARK Retouch or from ARK Navigator (we should consider separating folder picker into re-usable repo).

ARK Navigator should be able to process saved files (see #37).

Add link to an empty folder.
Duplicate the link file in the folder.
Reload the app.
List shows the same link twice.

The app should filter links with the same Id.

debug builds: enabled by default
release builds: disabled, but can be enabled

Also, would be great to implement manual sending of current log.

Since, we have same feature in Navigator (see ARK-Builders/ARK-Navigator@cf38b61 and ARK-Builders/ARK-Navigator#78), it would be great to extract common functionality into tiny lib. We would inject such a lib into all of our apps.

Adopt shared file picker component

Let's use shared component: https://github.com/ARK-Builders/ark-filepicker
If filepicker in this repo has some extra functionality, it must be incorporated into the shared repo.