kittyfangs
/
fchat-rising
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
fchat-rising/readme.md

7.9 KiB
Raw Blame History

F-Chat Rising

This repository contains a heavily customized version of the mainline F-Chat 3.0 client.

Key Differences

  1. Profile matching automatically compares your profile with others to determine with whom you are compatible.
  2. Automatic ad posting repeatedly posts and rotates ads on selected channels.
  3. Link previews popup shows a preview of an image / video when you hover your mouse over a link.
  4. Caching speeds up profile loads and other actions.

More Detailed Differences

  • Channel Conversations
    • Highlight ads from characters most interesting to you
    • Hide clearly unmatched ads
  • Ad Auto-Posting
    • Manage channel ad settings via "Tab Settings"
    • Automatically re-post ads every 11-18 minutes (randomized) for up to 180 minutes
    • Rotate multiple ads on a single channel by entering multiple ads in "Ad Settings"
  • Ad Ratings
    • LFP ads are automatically rated (great/good/maybe/no) and matched against your profile
  • Private Conversations
    • View a characters' recent ads
  • Link Previews
    • Hover cursor over any [url] to see a preview of it
    • Middle click any [url] to turn the preview into a sticky / interactive mode
    • Link preview has an ad-blocker to minimize page load times and protect against unfriendly scripts
  • Profile
    • Kinks are auto-compared when viewing character profile
    • Custom kink explanations can be expanded inline
    • Custom kinks are highlighted
    • Gender, anthro/human preference, age, sexual preference, and sub/dom preference are highlighted if compatible or incompatible
    • Guestbook, friend, and group counts are visible on tab titles
    • Character images are expanded inline
    • Cleaner presentation for the side bar details (age, etc.), sorted in most relevant order
    • Less informative side bar details (views, contact) are separated and shown in a less prominent way
    • Cleaner guestbook view
    • Profiles, images, guestbook posts, and groups are cached for faster view
    • Character view tabs (overview, images, etc.) stick to the top
  • Character Search
    • Search results are sorted based on match scores
    • Display match score in search results
    • Current search filters are listed in the search dialog
    • Search filters can be reset
    • Search results can be filtered by species
    • Last 15 searches are stored and can be accessed from the 'Character search' dialog
  • Character Status Message
    • Last 10 status messages are stored and can be accessed from the 'Set status' dialog
  • General
    • Character profiles, guestbooks, friend lists, and image lists are cached for faster access
    • Conversation dialog can be opened by typing in a character name
    • Message search matches character names
    • PM list shows characters' online status as a colored icon
  • Technical Details for Nerds
    • Upgraded to Electron 9.x
    • Replaced node-spellchecker with the built-in spellchecker that ships with Electron 8+
    • Multi-language support for spell checking (Windows only – language is autodetected on MacOS)

How to Set Up Ads

  1. Open a conversation channel of your preference, such as #Sex Driven LFRP
  2. Locate Ads dropdown at the top right corner of the channel view
  3. Click Ads > Edit Channel Ads
  4. Enter one or more ads
  5. Click Save settings
  6. Click Ads > Start Posting Ads
  7. To stop, click Ads > Stop Posting Ads

FAQ

  1. The more information you have in your profile (non-custom kinks in particular), the better the matching quality will be. The algorithm considers the following data points:
    • Age
    • Gender
    • Sexual preference
    • Dominance preference
    • Human/anthro preference
    • Non-custom kinks
    • Species
  2. Maching for non-binary genders relies on kinks. For example, if your non-binary character has a preference for females, make sure 'females' are listed as a favorite kink.
  3. 'Underage' kink is considered to apply to characters aged 16 or above; 'ageplay' kink is considered to apply to characters aged 16 or below.
  4. 'Older characters' and 'younger characters' kink preferences are interpreted as age difference of 5+ years.
  5. Comparison results will get faster over time, as more and more character data is cached.

Todo / Ideas

  • Collect data on ads / responses to determine which ads work best
  • Preview mode should allow detaching from the main window
  • Improve log browsing
  • Conversation bot API
  • 'Filter unmatching ads' is not channel specific -- it's either on everywhere or nowhere
  • Bug? Usually submissive vs usually submissive shows up as 'maybe'
  • Bug? YOU have 'loves humans'; THEY have 'no furry characters, just humans' -- THEIR ad shows green, not red -- your side of comparison is fully green, they just have 'no furry pairings' in red
  • Bug? [color] acts weird
  • Add new chat is case sensitive

F-List Exported

This repository contains the open source parts of F-list and F-Chat 3.0. All necessary files to build F-Chat 3.0 as an Electron, mobile or web application are included.

Setting up a Dev Environment

  • Clone the repo
  • Install Yarn
  • Change into the cloned directory and run yarn install. If you only want to make a custom theme, you do not need to do this!
  • IntelliJ IDEA is recommended for development.

Building for Electron

  • To build native Node assets, you will need to install Python 2.7 and the Visual C++ 2015 Build tools. More information can be found in the node-gyp docs.
  • Change into the electron directory.
  • Run yarn build/yarn watch to build assets. They are placed into the app directory.
  • Run yarn start to start the app in debug mode. Use Ctrl+Shift+I to open the Chromium debugger.

Building on Windows

npm install --global --production --vs2015 --add-python-to-path windows-build-tools node-gyp

Packaging

See https://electron.atom.io/docs/tutorial/application-distribution/

  • Run yarn build:dist to create a minified production build.
  • Run yarn run pack. The generated installer is placed into the dist directory.
    • On Windows you can add the path to and password for a code signing certificate as arguments.
    • On Mac you can add your code signing identity as an argument. zip is required to be installed.
    • On Linux you can add a GPG key for signing and its password as arguments. mksquashfs and zsyncmake are required to be installed.

Building for Mobile

  • Change into the mobile directory.
  • Run yarn build/yarn watch to build assets. They are placed into the www directory.
  • For Android, change into the android directory and run ./gradlew assembleDebug. The generated APK is placed into app/build/outputs/apk.
  • For iOS, change into the ios directory and open F-Chat.xcodeproj using XCode. From there, simply run the app using the play button.

Building for Web

  • Change into the webchat directory.
  • Run yarn build/yarn watch to build assets. They are placed into the dist directory.
  • The compiled main.js file can be included by an HTML file that is expected to provide a global const chatSettings: {account: string, theme: string, characters: ReadonlyArray<string>, defaultCharacter: string | null};. It should also normalize the page to 100% height.

Building a custom theme

See the wiki for instructions on how to create a custom theme.

  • Change into the scss directory.
  • Run yarn install.
  • Run yarn build themes/chat/{name}.scss.
  • Your theme file will be placed into the scss/css directory.

Dependencies

Note: Adding and upgrading dependencies should only be done with prior consideration and subsequent testing.

That's why yarn.lock exists and is version controlled.

To upgrade NPM dependencies, run yarn upgrade locally. Run yarn outdated to see pending upgrades.