ACM

Bases: Client

Source code in aminofixfix/asyncfixfix/acm.py
class ACM(client.Client):
    def __init__(
        self, profile: objects.UserProfile, comId: str = None, proxies: dict = None
    ):
        client.Client.__init__(self)

        self.profile = profile
        self.comId = comId
        self.proxies = proxies

    # TODO : Finish the imaging sizing, might not work for every picture...
    async def create_community(
        self,
        name: str,
        tagline: str,
        icon: BinaryIO,
        themeColor: str,
        joinType: int = 0,
        primaryLanguage: str = "en",
    ):
        data = dumps(
            {
                "icon": {
                    "height": 512.0,
                    "imageMatrix": [
                        1.6875,
                        0.0,
                        108.0,
                        0.0,
                        1.6875,
                        497.0,
                        0.0,
                        0.0,
                        1.0,
                    ],
                    "path": self.upload_media(icon),
                    "width": 512.0,
                    "x": 0.0,
                    "y": 0.0,
                },
                "joinType": joinType,
                "name": name,
                "primaryLanguage": primaryLanguage,
                "tagline": tagline,
                "templateId": 9,
                "themeColor": themeColor,
                "timestamp": inttime(),
            }
        )

        response = await self.session.post(
            f"/g/s/community", headers=self.additional_headers(data=data), data=data
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def delete_community(self, email: str, password: str, verificationCode: str):
        data = dumps(
            {
                "secret": f"0 {password}",
                "validationContext": {
                    "data": {"code": verificationCode},
                    "type": 1,
                    "identity": email,
                },
                "deviceID": self.device_id,
            }
        )

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/g/s-x{self.comId}/community/delete-request",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def list_communities(self, start: int = 0, size: int = 25):
        response = await self.session.get(
            f"/g/s/community/managed?start={start}&size={size}",
            headers=self.additional_headers(),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return objects.CommunityList(response.json()["communityList"]).CommunityList

    async def get_categories(self, start: int = 0, size: int = 25):
        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.get(
            f"/x{self.comId}/s/blog-category?start={start}&size={size}",
            headers=self.additional_headers(),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.json()

    async def change_sidepanel_color(self, color: str):
        data = dumps(
            {
                "path": "appearance.leftSidePanel.style.iconColor",
                "value": color,
                "timestamp": inttime(),
            }
        )

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/configuration",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return response.status_code
        else:
            return response.json()

    async def get_themepack_info(self, file: BinaryIO):
        """
        This method can be used for getting info about current themepack of community.
        """
        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.get(
            f"/g/s-x{self.comId}/community/info?withTopicList=1&withInfluencerList=1&influencerListOrderStrategy=fansCount",
            data=file.read(),
            headers=headers.Headers(data=file.read()).s_headers,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return await response.json()["community"]["themePack"]

    async def upload_themepack_raw(self, file: BinaryIO):
        """
        Uploading new themepack.

        File is technically a ZIP file, but you should rename .zip to .ndthemepack.
        Also this "zip" file have specific stucture.

        The structure is:
        - theme_info.json
        - images/
            - background/
                - background_375x667.jpeg
                - background_750x1334.jpeg
            - logo/
                - logo_219x44.png
                - logo_439x88.png
            - titlebar/
                - titlebar_320x64.jpeg
                - titlebar_640x128.jpeg
            - titlebarBackground/
                - titlebarBackground_375x667.jpeg
                - titlebarBackground_750x1334.jpeg

        And now its time to explain tricky "theme.json".

        - I can't really explain "id" here, *maybe* its random uuid4.
        - "format-version" **SHOULD** be "1.0", its themepack format version
        - "author" is.. nickname or aminoId of theme uploader (or agent, it doesnt matter)
        - "revision".. u *can* leave revision that you have, Amino will do all stuff instead of you
        - "theme-color" should be **VALID** hex color. I think they didn't fixed that you can pass invalid hex color, but it will cost a crash on every device

        About images in "theme.json":

        - for logo folder stands key "logo" in json, for titlebar - "titlebar-image", for titlebarBackground - "titlebar-background-image", for background - "background-image"
        - you can *pass* or *not pass* these keys in json, if they are not passed they will ignored/deleted
        - keys have array values like this:
            - [
                {
                    "height": height*2,
                    "path": "images/logo/logo_width*2xheight*2.png",
                    "width": width*2,
                    "x": 0,
                    "y": 0
                },
                {
                    "height": height,
                    "path": "images/logo/logo_widthxheight.png",
                    "width": width,
                    "x": 0,
                    "y": 0
                }
            ]
        - default values of height (h) and width (w) for every key:
            - "background-image":
                - w = 375
                - h = 667
            - "logo":
                - w = 196
                - h = 44
            - "titlebar-background-image":
                - w = 375
                - h = 667
            - "titlebar-image":
                - w = 320
                - h = 64
        - you *can* specify "x" and "y" if you want
        - theoretically you can provide different "w" and "h"
        """
        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/media/upload/target/community-theme-pack",
            data=file.read(),
            headers=headers.Headers(data=file.read()).s_headers,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.json()

    async def promote(self, userId: str, rank: str):
        rank = rank.lower().replace("agent", "transfer-agent")

        if rank.lower() not in ["transfer-agent", "leader", "curator"]:
            raise exceptions.WrongType(rank)

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/user-profile/{userId}/{rank}",
            data="",
            headers=self.additional_headers(""),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def get_join_requests(self, start: int = 0, size: int = 25):
        if self.comId is None:
            raise exceptions.CommunityNeeded()

        response = await self.session.get(
            f"/x{self.comId}/s/community/membership-request?status=pending&start={start}&size={size}",
            headers=self.additional_headers(),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return objects.JoinRequest(response.json()).JoinRequest

    async def accept_join_request(self, userId: str):
        data = dumps({})

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/membership-request/{userId}/accept",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def reject_join_request(self, userId: str):
        data = dumps({})

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/membership-request/{userId}/reject",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def get_community_stats(self):
        if self.comId is None:
            raise exceptions.CommunityNeeded()

        response = await self.session.get(
            f"/x{self.comId}/s/community/stats", headers=self.additional_headers()
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return objects.CommunityStats(
                response.json()["communityStats"]
            ).CommunityStats

    async def get_community_user_stats(self, type: str, start: int = 0, size: int = 25):
        if self.comId is None:
            raise exceptions.CommunityNeeded()

        if type.lower() == "leader":
            target = "leader"
        elif type.lower() == "curator":
            target = "curator"
        else:
            raise exceptions.WrongType(type)

        response = await self.session.get(
            f"/x{self.comId}/s/community/stats/moderation?type={target}&start={start}&size={size}",
            headers=self.additional_headers(),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return objects.UserProfileList(
                response.json()["userProfileList"]
            ).UserProfileList

    async def change_welcome_message(self, message: str, isEnabled: bool = True):
        data = dumps(
            {
                "path": "general.welcomeMessage",
                "value": {"enabled": isEnabled, "text": message},
                "timestamp": inttime(),
            }
        )

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/configuration",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def change_guidelines(self, message: str):
        data = dumps({"content": message, "timestamp": inttime()})

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/guideline",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def edit_community(
        self,
        name: str = None,
        description: str = None,
        aminoId: str = None,
        primaryLanguage: str = None,
        themePackUrl: str = None,
    ):
        data = {"timestamp": inttime()}

        if name is not None:
            data["name"] = name
        if description is not None:
            data["content"] = description
        if aminoId is not None:
            data["endpoint"] = aminoId
        if primaryLanguage is not None:
            data["primaryLanguage"] = primaryLanguage
        if themePackUrl is not None:
            data["themePackUrl"] = themePackUrl

        data = dumps(data)

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/settings",
            data=data,
            headers=self.additional_headers(data=data),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def change_module(self, module: str, isEnabled: bool):
        if module.lower() == "chat":
            mod = "module.chat.enabled"
        elif module.lower() == "livechat":
            mod = "module.chat.avChat.videoEnabled"
        elif module.lower() == "screeningroom":
            mod = "module.chat.avChat.screeningRoomEnabled"
        elif module.lower() == "publicchats":
            mod = "module.chat.publicChat.enabled"
        elif module.lower() == "posts":
            mod = "module.post.enabled"
        elif module.lower() == "ranking":
            mod = "module.ranking.enabled"
        elif module.lower() == "leaderboards":
            mod = "module.ranking.leaderboardEnabled"
        elif module.lower() == "featured":
            mod = "module.featured.enabled"
        elif module.lower() == "featuredposts":
            mod = "module.featured.postEnabled"
        elif module.lower() == "featuredusers":
            mod = "module.featured.memberEnabled"
        elif module.lower() == "featuredchats":
            mod = "module.featured.publicChatRoomEnabled"
        elif module.lower() == "sharedfolder":
            mod = "module.sharedFolder.enabled"
        elif module.lower() == "influencer":
            mod = "module.influencer.enabled"
        elif module.lower() == "catalog":
            mod = "module.catalog.enabled"
        elif module.lower() == "externalcontent":
            mod = "module.externalContent.enabled"
        elif module.lower() == "topiccategories":
            mod = "module.topicCategories.enabled"
        else:
            raise exceptions.SpecifyType()

        data = dumps({"path": mod, "value": isEnabled, "timestamp": inttime()})

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/community/configuration",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def add_influencer(self, userId: str, monthlyFee: int):
        data = dumps({"monthlyFee": monthlyFee, "timestamp": inttime()})

        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.post(
            f"/x{self.comId}/s/influencer/{userId}",
            headers=self.additional_headers(data=data),
            data=data,
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def remove_influencer(self, userId: str):
        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.delete(
            f"/x{self.comId}/s/influencer/{userId}", headers=self.additional_headers()
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

    async def get_notice_list(self, start: int = 0, size: int = 25):
        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.get(
            f"/x{self.comId}/s/notice?type=management&status=1&start={start}&size={size}",
            headers=self.additional_headers(),
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return objects.NoticeList(response.json()["noticeList"]).NoticeList

    async def delete_pending_role(self, noticeId: str):
        if self.comId is None:
            raise exceptions.CommunityNeeded()
        response = await self.session.delete(
            f"/x{self.comId}/s/notice/{noticeId}", headers=self.additional_headers()
        )
        if response.status_code != 200:
            return exceptions.CheckException(response)
        else:
            return response.status_code

get_themepack_info(file) async

This method can be used for getting info about current themepack of community.

Source code in aminofixfix/asyncfixfix/acm.py
async def get_themepack_info(self, file: BinaryIO):
    """
    This method can be used for getting info about current themepack of community.
    """
    if self.comId is None:
        raise exceptions.CommunityNeeded()
    response = await self.session.get(
        f"/g/s-x{self.comId}/community/info?withTopicList=1&withInfluencerList=1&influencerListOrderStrategy=fansCount",
        data=file.read(),
        headers=headers.Headers(data=file.read()).s_headers,
    )
    if response.status_code != 200:
        return exceptions.CheckException(response)
    else:
        return await response.json()["community"]["themePack"]

upload_themepack_raw(file) async

Uploading new themepack.

File is technically a ZIP file, but you should rename .zip to .ndthemepack. Also this "zip" file have specific stucture.

The structure is: - theme_info.json - images/ - background/ - background_375x667.jpeg - background_750x1334.jpeg - logo/ - logo_219x44.png - logo_439x88.png - titlebar/ - titlebar_320x64.jpeg - titlebar_640x128.jpeg - titlebarBackground/ - titlebarBackground_375x667.jpeg - titlebarBackground_750x1334.jpeg

And now its time to explain tricky "theme.json".

  • I can't really explain "id" here, maybe its random uuid4.
  • "format-version" SHOULD be "1.0", its themepack format version
  • "author" is.. nickname or aminoId of theme uploader (or agent, it doesnt matter)
  • "revision".. u can leave revision that you have, Amino will do all stuff instead of you
  • "theme-color" should be VALID hex color. I think they didn't fixed that you can pass invalid hex color, but it will cost a crash on every device

About images in "theme.json":

  • for logo folder stands key "logo" in json, for titlebar - "titlebar-image", for titlebarBackground - "titlebar-background-image", for background - "background-image"
  • you can pass or not pass these keys in json, if they are not passed they will ignored/deleted
  • keys have array values like this:
    • [ { "height": height2, "path": "images/logo/logo_width2xheight2.png", "width": width2, "x": 0, "y": 0 }, { "height": height, "path": "images/logo/logo_widthxheight.png", "width": width, "x": 0, "y": 0 } ]
  • default values of height (h) and width (w) for every key:
    • "background-image":
      • w = 375
      • h = 667
    • "logo":
      • w = 196
      • h = 44
    • "titlebar-background-image":
      • w = 375
      • h = 667
    • "titlebar-image":
      • w = 320
      • h = 64
  • you can specify "x" and "y" if you want
  • theoretically you can provide different "w" and "h"
Source code in aminofixfix/asyncfixfix/acm.py
async def upload_themepack_raw(self, file: BinaryIO):
    """
    Uploading new themepack.

    File is technically a ZIP file, but you should rename .zip to .ndthemepack.
    Also this "zip" file have specific stucture.

    The structure is:
    - theme_info.json
    - images/
        - background/
            - background_375x667.jpeg
            - background_750x1334.jpeg
        - logo/
            - logo_219x44.png
            - logo_439x88.png
        - titlebar/
            - titlebar_320x64.jpeg
            - titlebar_640x128.jpeg
        - titlebarBackground/
            - titlebarBackground_375x667.jpeg
            - titlebarBackground_750x1334.jpeg

    And now its time to explain tricky "theme.json".

    - I can't really explain "id" here, *maybe* its random uuid4.
    - "format-version" **SHOULD** be "1.0", its themepack format version
    - "author" is.. nickname or aminoId of theme uploader (or agent, it doesnt matter)
    - "revision".. u *can* leave revision that you have, Amino will do all stuff instead of you
    - "theme-color" should be **VALID** hex color. I think they didn't fixed that you can pass invalid hex color, but it will cost a crash on every device

    About images in "theme.json":

    - for logo folder stands key "logo" in json, for titlebar - "titlebar-image", for titlebarBackground - "titlebar-background-image", for background - "background-image"
    - you can *pass* or *not pass* these keys in json, if they are not passed they will ignored/deleted
    - keys have array values like this:
        - [
            {
                "height": height*2,
                "path": "images/logo/logo_width*2xheight*2.png",
                "width": width*2,
                "x": 0,
                "y": 0
            },
            {
                "height": height,
                "path": "images/logo/logo_widthxheight.png",
                "width": width,
                "x": 0,
                "y": 0
            }
        ]
    - default values of height (h) and width (w) for every key:
        - "background-image":
            - w = 375
            - h = 667
        - "logo":
            - w = 196
            - h = 44
        - "titlebar-background-image":
            - w = 375
            - h = 667
        - "titlebar-image":
            - w = 320
            - h = 64
    - you *can* specify "x" and "y" if you want
    - theoretically you can provide different "w" and "h"
    """
    if self.comId is None:
        raise exceptions.CommunityNeeded()
    response = await self.session.post(
        f"/x{self.comId}/s/media/upload/target/community-theme-pack",
        data=file.read(),
        headers=headers.Headers(data=file.read()).s_headers,
    )
    if response.status_code != 200:
        return exceptions.CheckException(response)
    else:
        return response.json()