Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/neatia/Loom

A iOS and macOS client for the fediverse. Written in SwiftUI.
https://github.com/neatia/Loom

client federation ios ipfs macos swift swiftui

Last synced: about 2 months ago
JSON representation

A iOS and macOS client for the fediverse. Written in SwiftUI.

Host: GitHub
URL: https://github.com/neatia/Loom
Owner: neatia
License: mit
Created: 2023-08-02T04:52:10.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-08-25T05:53:37.000Z (5 months ago)
Last Synced: 2024-09-07T05:22:58.002Z (4 months ago)
Topics: client, federation, ios, ipfs, macos, swift, swiftui
Language: Swift
Homepage:
Size: 12.1 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-lemmy - Loom - activity/y/neatia/Loom) | iOS, macOS (Projects / Mobile / Desktop apps)

README

        


Loom (iOS & macOS) Beta




Aggregating aggregation. Providing everyone with a premium experience when interacting with federated servers. Meanwhile, providing view libraries and solutions for others to implement their own interpretations in the Apple ecosystem.


## WARNING

- If Loom requests for "Local Network Access" it is because a neighboring server is using a localhost equivalent address. It is not because of the application itself. So please DO NOT ALLOW ACCESS. (unless you are expecting it).

## Requirements

![Swift Compatibility](https://img.shields.io/badge/Swift-5.9%20%7C%205.8%20%7C%205.7-orange?logo=swift)

![Platform Compatibility](https://img.shields.io/badge/Platform-iOS%20%7C%20macOS-blue)

[![License](https://img.shields.io/badge/License-MIT--Clause-orange.svg)](https://opensource.org/license/mit/)

> My local environment: Xcode 14.2 or later // macOS (Intel) 12.6 or later // iOS 15.4 or later

## Disclaimers

- Due to the nature of possible state schemas being changed. Saved data such as account information or bookmarks may be removed in future release versions (or not at all).

- Keychain access warning. Keychain is only used for STORING your passwords and nothing else.

## Features

- Translated into 28 languages (MTL)

- Bookmarks are locally stored for offline viewing

- IPFS Content generation (Add your own config, gateway, etc)

- Login, Create Posts, Comments, Interact, update profiles as normal

| Expanded Layout (iPad/macOS)   | |

| :-------- | -------: |

| ![Image](Resources/README/1.gif) | [Granite](https://github.com/pexavc/Granite) supports macOS. Same navigation API can direct window spawning or navigation stack pushing. |

| ![Image](Resources/README/2.png) | Spawn multiple windows of entire feed layouts with multiple communities to observe. Will be helpful in the case of moderating multiple communities for instance. |

| Looms    | |

| :-------- | -------: |

| ![Image](Resources/README/3.gif) | Create "Looms" of any group of communities from any instance. Merging their content into a singular feed.|

| Explore    | |

| :-------- | -------: |

| ![Image](Resources/README/4.gif)  | Visit linked instances when connected to a lemmy server. View small snippets of each and their ping response time.   |

| Aggregation Sources (Aside from Lemmy)    | |

| :-------- | -------: |

| ![Image](Resources/README/5.gif)  | RSS feeds can be pulled when setting the instance URL to a valid endpoint. Pagination is not currently supported, but will be in the future. Looking at supporting Atom/JSON streams as well.   |

| ![Image](Resources/README/6.gif)  | Mastodon feeds can be pulled when setting the instance URL to a valid mastodon instance. Pagination is not currently supported, but will be in the future. Interactions are disabled for the time being `2023-9-4`.   |

| Safety    | |

| :-------- | -------: |

| ![Image](Resources/README/7.gif)  | On-device CoreML models + keyword filtering to remove posts from the feed. `NSFW Extended` will remove posts that are detected as NSFW even if they are not flagged as so.     |

| Styling    | |

| :-------- | -------: |

| ![Image](Resources/README/8.gif)  |  Intended to allow full user customization in the future. Currently supports a "social app feel" and a "reddit-like reader".   |

| MD helper  | |

| :-------- | -------: |

| ![Image](Resources/README/9.gif) | Keyboard toolbar provides easy to access shortcuts on iPhone/iPad to help with Markdown formatting. |

| Travelling Modals    | |

| :-------- | -------: |

| ![Image](Resources/README/10.gif)  | Writing modals can travel with your viewing context. Allowing you to browse content in any stack prior to publishing.   |

| Bookmark Syncing    | |

| :-------- | -------: |

| ![Image]()  | All your saved posts and comments can be switched between accounts in a dedicated component.   |

| Sharing    | |

| :-------- | -------: |

| ![Image](Resources/README/11.gif) | Share posts or comments as images. With the intention of supporting QR codes and *Engravings* in the future. |

| Search    | |

| :-------- | -------: |

| ![Image](Resources/README/12.gif) | Either search all, a specific subcategory with sort support. View expanded contents within the view, interacting with content as normal. |

| Profile    | |

| :-------- | -------: |

| ![Image](Resources/README/13.gif) | Dynamic threads, despite viewing context. Swipe to reply to comments or tap the more button, to modify, remove, block, etc.  |

| ![Image](Resources/README/14.gif) | Deleting and restoring with toast reactions. |

| ![Image](Resources/README/15.gif) | Switch accounts, view their profiles, and their scores. |

| Embedded Webview    | |

| :-------- | -------: |

| ![Image](Resources/README/16.gif) | Custom JS insertion supported, customizing how webpages are viewed via direct user input is a possibility. |

| Light Mode    | |

| :-------- | -------: |

| ![Image](Resources/README/17.gif) | Light mode and Dark mode supported. Refer to the color group in `Assets` to define your own preferences for each. |

## Contributing

Loom uses [Granite](https://github.com/pexavc/Granite) as a backing for components and services. The Components folder in this repo serves as a good example for many future components that may be needed. Any suggestions on Granite or other component layouts as a whole is greatly appreciated. Always feel free to open a PR and/or Issue.

An interactive websites to generate boilerplate components using a GUI to define styling and needed state properties is in the works! This will allow you to simply download the generated component and drag into XCode for immediate use.

### Why Granite?

Mostly because of *Relays* and project organization. I'd say testing too, but once I get around towards writing the unit tests, I'd feel more confident in sharing the strengths then. These work like @Observables/@AppStorage, but are more flexible in initializations and caching data. The ability to simply declare relays in any `View` or `GraniteComponent` allows for a more effective iterative process and cleaner context passing throughout the application.

```swift

@Relay var configService: ConfigService

```

## Swift Packages

- [Granite](https://github.com/pexavc/Granite)

- [MarqueKit](https://github.com/pexavc/marquekit)

- [MarbleKit](https://github.com/pexavc/marblekit)

- [ModerationKit](https://github.com/pexavc/moderationkit)

- [FederationKit](https://github.com/neatia/federationkit)

- [IPFSKit](https://github.com/pexavc/ipfskit)

- [NukeUI](https://github.com/kean/nuke) Thanks to [@kean](https://github.com/kean)

- [MarkdownView](https://github.com/pexavc/MarkdownView) Thanks to [@LiYanan2004](https://github.com/LiYanan2004)

- [KeyboardToolbar](https://github.com/simonbs/KeyboardToolbar) Thanks to [@simonbs](https://github.com/simonbs)

### Contact

- [Twitter @pexavc](https://twitter.com/pexavc)