Skip to content

Latest commit

 

History

History
70 lines (38 loc) · 2.9 KB

README.md

File metadata and controls

70 lines (38 loc) · 2.9 KB

Asobi

An immersive browser application for iOS, iPadOS, and MacCatalyst.

Download on the App Store for iOS/iPadOS and MacOS

https://apps.apple.com/us/app/asobi/id1589812837

Why did I make this?

I really like to watch and read various forms of media. However, most web browsers have a TON of clutter surrounding the webpage I want to use. With desktop browsers, you can go full screen and not have to worry. However, mobile browsers don't have that luxury for all websites.

Some browsers don't even allow you to hide the URL bar!

Asobi removes all of this clutter by giving you a WebView with a minimalist navigation bar (and swipe gestures). By doing these things, you can have a distraction free browsing experience.

Why not use Safari web clips?

Well, safari web clips are great. They can easily save/load PWAs in an immersive feeling. However, these snippets don't allow for image saving, proper navigation, and sometimes are annoying to fiddle around with.

Initial Setup

When you open the app for the first time, you will see DuckDuckGo (or whatever the fallback webpage to load is). This is because you haven't set a default URL to navigate to on app load!

To set a default URL:

  1. Open settings
  2. Scroll to the bottom option that says Default URL
  3. Enter your favorite URL in the textbox and the site should load immediately, when you press the home button, or when you close/reopen the app

Planned features

Here are features that I have planned for future releases (these are also in the issues)

  • RPC on mac: Used for Discord to show that you're using Asobi
  • Find in page: Adds the ability to search for content in a webpage

Building from source

If you have Xcode, you can build Asobi from source and run it on your device.

There are two branches in the repository:

  • default: The stable branch. Is parallel to the App Store version of Asobi.
  • next: The development branch. May contain breaking changes and is frequently force pushed to.

Xcode builds are ran at your own risk and are not guaranteed to get support in the event of an app crash!

Contribution

If you have issues with the app:

  • Describe the issue in detail
  • If you have a feature request, please indicate it as so. Planned features are in a different section of the README, so be sure to read those before submitting.

If you want to make custom icons for the app:

Developers and Permissions

I try to make comments/commits as detailed as possible, but if you don't understand something, please contact me via Discord or Twitter! I'm always happy to talk!

Creator/Developer: Brian Dashore

Developer Website: kingbri.dev

Developer Discord: kingbri#6666

Join the support discord here (get the king-updates role to access the channel): https://discord.gg/pswt7by