Skip to content

Latest commit

 

History

History
177 lines (119 loc) · 11 KB

README.md

File metadata and controls

177 lines (119 loc) · 11 KB

Anatawa12's fork of Misskey

This is anatawa12's fork of Misskey.

This fork is used for several purposes:

  • The repository for vmimi-relay timeline extension development. I'm the maintainer of the vmimi-relay timeline.
  • The repository for writing pull-requests to the vmimi relay users. I'm usually sending pull requests to the vmimi relay users after each updates.
  • The repository for writing pull-requests to the upstream repository. I'm one of the contributors of the upstream repository.
  • The repository for writing pull-requests to the misskey.niri.la. I'm one of the maintainers of the misskey.niri.la.

This branch is the branch for releasing the Vmimi Relay Timeline extension.

Vmimi Relay Timeline

The Vmimi Relay Timeline is additional timelines for Misskey servers who belong to the Virtual Kemomimi Relay. This extension adds two timelines: Vmimi Relay Timeline (VRTL) and Vmimi Social Timeline (VSTL).

ぶいみみリレータイムラインはぶいみみリレーに参加しているサーバー向けのmisskeyの拡張タイムラインです。 この拡張はふたつのタイムラインを追加します: ぶいみみリレータイムライン (VRTL) とぶいみみソーシャルタイムライン (VSTL) です。

Vmimi Relay Timeline (VRTL)

The Vmimi Relay Timeline (VRTL) is the timeline that shows the posts from the Virtual Kemomimi Relay users. This timeline is designed to be similar to the Local Timeline, but it shows the posts from the Virtual Kemomimi Relay users.

ぶいみみリレータイムライン (VRTL) はぶいみみリレーに参加しているユーザーの投稿を表示するタイムラインです。 このタイムラインはローカルタイムラインに似ていますが、ぶいみみリレーに参加しているユーザーの投稿を表示します。

Vmimi Social Timeline (VSTL)

The Vmimi Social Timeline (VSTL) is the timeline that shows the posts from the Virtual Kemomimi Relay users and the users you are following. In other words, this timeline is the combination of the VRTL and the Home Timeline. This timeline is designed to be similar to the Social Timeline, but it shows the posts from the Virtual Kemomimi Relay users instead of the Local Timeline.

ぶいみみソーシャルタイムライン (VSTL) はぶいみみリレーに参加しているユーザーとフォローしているユーザーの投稿を表示するタイムラインです。 つまり、このタイムラインはVRTLとホームタイムラインの組み合わせです。 このタイムラインはソーシャルタイムラインに似ていますが、ローカルタイムラインの代わりにぶいみみリレーに参加しているユーザーの投稿を表示します。

How to use the Vmimi Relay Timeline

First, this extension is designed for servers who joined the Virtual Kemomimi Relay so you have to join the Virtual Kemomimi Relay to use this extension.

After that, you have two ways to use the Vmimi Relay Timeline:

  • Use releases of the misskey docker image if you're using official docker image. The image is designed to be a drop-in replacement of the official image. The image name is ghcr.io/anatawa12/vrtl-misskey:latest.
  • Merge the extension branch to your fork and build the image by yourself. You can merge the vmimi-relay-timeline/generic branch to your fork. If you ask me, I'll create a pull request to your fork. Feel free to ask me.

はじめに、この拡張はぶいみみリレーに参加しているサーバー向けに設計されているため、この拡張を使用するにはぶいみみリレーに参加する必要があります。

その後、ぶいみみリレータイムラインを使用する方法はふたつあります:

  • 公式のdockerイメージを使用している場合は、VRTLのdockerイメージを使用してください。 のイメージは公式イメージの代わりとして使用できます。 イメージ名は ghcr.io/anatawa12/vrtl-misskey:latest です。
  • このブランチをあなたのフォークにマージして、自分でイメージをビルドしてください。 vmimi-relay-timeline/generic ブランチをあなたのフォークにマージすることで、この拡張を使用できます。 必要であれば、あなたのフォークにプルリクエストを作成します。お気軽にお尋ねください。

Notes for Third-party Client Developers

Here are the technical notes for third-party misskey client developers.

サードパーティ Misskey クライアント向けの技術的な情報です

Detecting Vmimi Relay Timeline

There is vmimiRelayTimelineImplemented property on metadata object of nodeinfo. If it's true, your client can assume that the VRTL is implemented for the sever.

nodeinfometadataオブジェクトにvmimiRelayTimelineImplementedプロパティがあります。 この値が true であれば、VRTLがそのサーバーにて実装されてると考えて問題ありません

Endpoints and Channels of Vmimi Relay Timeline

The fetch note endpoint for VRTL and VSTL are notes/vmimi-relay-timeline and notes/vmimi-relay-hybrid-timeline, and the channel name for them are vmimiRelayTimeline and vmimiRelayHybridTimeline.

Those endpoints and channels have almost same options as LTL / STL but they have one extra option specific to VRTL/VSTL. The withLocalOnly flag (true by default) indicates if the timeline should include local only (non-federated) notes from server (local) timeline.

For more details, see misskey-js.

VRTLとVSTLのfetchエンドポイントはそれぞれ notes/vmimi-relay-timelinenotes/vmimi-relay-hybrid-timelineで、 チャンネルは vmimiRelayTimelinevmimiRelayHybridTimeline です。

これらのエンドポイントとチャンネルは LTL/STL とほぼ同じオプションを持っていますが、 VRTL/VSTL に固有オプションが一つあります。 withLocalOnly (デフォルトtrue) はタイムラインにローカルのみ(連合なし)ノートがタイムラインに含まれるかどうかを示します。

Branches related to Vmimi Relay Timeline

  • vmimi-relay-timeline/generic: The branch for the Vmimi Relay Timeline extension development. All changes to the Vmimi Relay Timeline extension will be merged to this branch. This branch should be based on the latest official release of Misskey. This branch does not include any changes other than the Vmimi Relay Timeline extension itself.
  • vmimi-relay-timeline/releases: The branch for releasing the Vmimi Relay Timeline extension. This branch includes the changes for package.json and changes to the repository link.
  • vmimi-relay-timeline/forks/nirila, vmimi-relay-timeline/forks/buiso and other branches: Those branches are the branches for sending pull requests to each fork-based server. Those branches are not permanent; they will be deleted after each pull request is merged.

How the Vmimi Relay Timeline works

The Vmimi Relay Timeline is implemented as a server-whitelisted timeline.

The Vmimi Relay provides the API endpoint to get the list of joined servers. The Vmimi Relay Timeline extension fetches the list of joined servers from the Vmimi Relay and filters the received / created notes by the list. For implementation simplicity, the Vmimi Relay Timeline includes all public notes of the local server including non-federated notes, but this behavior may change in the future.


Misskey logo

🌎 Misskey is an open source, federated social media platform that's free forever! 🚀

Learn more


find an instance create an instance become a contributor join the community become a patron

Thanks

Sentry

Thanks to Sentry for providing the error tracking platform that helps us catch unexpected errors.

Chromatic

Thanks to Chromatic for providing the visual testing platform that helps us review UI changes and catch visual regressions.

Codecov

Thanks to Codecov for providing the code coverage platform that helps us improve our test coverage.

Crowdin

Thanks to Crowdin for providing the localization platform that helps us translate Misskey into many languages.

Docker

Thanks to Docker for providing the container platform that helps us run Misskey in production.